No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, mechanical, electronic, photocopying, recording, or otherwise, without prior written permission of Apple Computer, Inc.
The Apple logo is a trademark of
Apple Computer, Inc.
Use of the “keyboard” Apple logo (Option-Shift-K) for commercial purposes without the prior written consent of Apple may constitute trademark infringement and unfair competition in violation of federal and state laws.
No licenses, express or implied, are granted with respect to any of the technology described in this book. Apple retains all intellectual property rights associated with the technology described in this book. This book is intended to assist application developers to develop applications only for Apple Macintosh computers.
Apple Computer, Inc.
20525 Mariani Avenue
Cupertino, CA 95014
408-996-1010
Apple, the Apple logo, APDA, AppleLink, ColorSync, GeoPort, LaserWriter, Macintosh, QuickDraw, QuickTake, QuickTime, and System 7 are trademarks of Apple Computer, Inc., registered in the United States and other countries.
Adobe Illustrator, PostScript are trademarks of Adobe Systems Incorporated, which may be registered in certain jurisdictions.
CompuServe is a registered trademark of CompuServe, Inc.
America Online is a service mark of Quantum Computer Services, Inc.
FrameMaker is a registered trademark of Frame Technology Corporation.
Helvetica and Palatino are registered trademarks of Linotype Company.
Internet is a trademark of Digital Equipment Corporation.
ITC Zapf Dingbats is a registered trademark of International Typeface Corporation.
Microsoft Windows is a registered trademark of Microsoft Corporation.
NuBus ia a trademark of Texas Instruments.
Simultaneously published in the United States and Canada.
Even though Apple has reviewed this manual, APPLE MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS MANUAL, ITS QUALITY, ACCURACY, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. AS A RESULT, THIS MANUAL IS SOLD “AS IS,” AND YOU, THE PURCHASER, ARE ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND ACCURACY.
IN NO EVENT WILL APPLE BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT OR INACCURACY IN THIS MANUAL, even if advised of the possibility of such damages.
THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL OTHERS, ORAL OR WRITTEN, EXPRESS OR IMPLIED. No Apple dealer, agent, or employee is authorized to make any modification, extension, or addition to this warranty.
Some states do not allow the exclusion or limitation of implied warranties or liability for incidental or consequential damages, so the above limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may also have other rights which vary from state to state.
Contents
Figures, Tables, and Listingsvii
Preface About This Noteix
Contents of This Notex
Supplementary Documentsx
For More Informationxi
Typographical Conventionsxii
Chapter 1 Introduction to the QuickTake 100 Camera1-1
QuickTake 100 Overview1-2
QuickTake 100 Developer Software1-3
Macintosh1-3
Windows1-4
QuickTake 100 Features1-4
User Controls1-4
Power On and Off1-4
Flash Button1-5
Erase-All Button1-6
Timer Button1-6
Resolution Button1-6
Shutter Button1-6
LCD Display1-7
Battery-Power Icon1-7
Pictures-Taken Indicator1-7
Pictures-Available Indicator1-7
Chapter 2 QuickTake 100 Driver Software2-1
QuickTake 100 Device Driver Overview2-2
Using the QuickTake 100 Driver Software2-3
Initializing the QuickTake 100 Device Driver2-3
Establishing a Connection With the Camera2-3
Capturing and Retrieving Images2-4
Closing the Camera Connection2-4
Closing the QuickTake 100 Device Driver2-5
Sample Code for Retrieving an Image From the Camera2-5
Asynchronous Operations2-7
QuickTake 100 Device Driver Reference2-8
Data Types for the QuickTake 100 Device Driver Functions2-8
QuickTake 100 Device Driver Functions2-19
Initializing and Closing the QuickTake 100 Device Driver2-20
Connecting With the Camera2-22
Controlling the Camera2-28
Retrieving and Capturing Images2-54
C-Language Summary of the QuickTake 100 Device Driver2-64
Constants2-64
Data Types2-65
Functions 2-68
Result Codes2-71
Chapter 3 QuickTake 100 Images3-1
QuickTake 100 Image Sizes3-2
Image Color Depth3-3
Chapter 4 Displaying QuickTake 100 Images in a Windows
Application4-1
Using the Windows IPM4-2
IPM Error Handling4-4
Image Processing Module Reference4-4
Data Types for the Windows IPM Functions4-4
IPM Functions for Microsoft Windows Applications4-7
C-Language Summary of the Image Processing Module4-21
Constants4-21
Data Types4-21
Functions4-22
Result Codes4-24
Chapter 5 Displaying QuickTake 100 Images in a Macintosh
Application5-1
QuickTake 100 QuickTime Decompressor5-2
Appendix A QuickTake 100 Serial InterfaceA-1
Serial PortA-1
Protocol, Transfer Rate, and Data FormatA-2
QuickTake 100 Serial Port Pin AssignmentsA-2
Serial CablesA-3
Appendix B QuickTake 100 Camera SpecificationsB-1
Figures, Tables, and Listings
Chapter 1 Introduction to the QuickTake 100 Camera1-1
Figure 1-1 QuickTake 100 lens cover in the open position1-5
Figure 1-2 QuickTake 100 LCD display and user control buttons 1-5
Figure 1-3 Rear view of the QuickTake 100 camera1-7
Figure A-6 QuickTake 100 8-pin mini-DIN to RS-232C serial cable and adapterA-4
Figure A-7 QuickTake 100 8-pin mini-DIN to D-sub 9-pin RS-232C serial cable pin assignmentsA-5
Figure A-8 D-sub 9-pin physical pinout on a QuickTake 100 to D-sub 9-pin serial cableA-5
Figure A-9 D-sub 9-pin physical pinout on a D-sub 9-pin to D-sub 25-pin adapter cableA-6
Figure A-10 D-sub 25-pin physical pinout on a D-sub 9-pin to D-sub 25-pin adapter cableA-6
Table A-1 Serial port pin assignmentsA-2
Appendix B QuickTake 100 Camera SpecificationsB-1
Table B-1 Venus specificationsB-2
About This Note
This developer note defines the QuickTake 100 software components provided for developers creating applications for either Apple Macintosh computers or computers capable of running Microsoft Windows. The QuickTake 100 software components are in the form of two application programming interfaces (APIs)—a QuickTake 100 camera device driver and an Image Processing Module (IPM).
The device driver software provides control services for QuickTake 100 digital computer camera. The camera control software is provided as a device driver and associated glue files for Macintosh computers and as a driver dynamic link library (DLL) for Microsoft Windows. The function names used for the QuickTake 100 driver interface and the QuickTake 100 DLL interface are identical for both the Macintosh and Windows platforms. The APIs for the IPM strictly apply to the Windows platform.
QuickTake 100 image processing software decompresses the image data that makes up a QuickTake 100 digital image once that data is present on the host computer. Image processing is performed by a QuickTime decompressor component on the Macintosh computer and by a QuickTake 100 IPM dynamic link library for Microsoft Windows applications.
This note assumes that you are already familiar with the hardware and software technology of Macintosh computers and computers capable of running Microsoft Windows software. If you are unfamiliar with Macintosh software and hardware, you may want to obtain copies of the related technical manuals listed in “Supplementary Documents,” later in this preface.
While every attempt has been made to verify the accuracy of the information presented, it is subject to change without notice. This developer note may contain information or specifications that are still under consideration by Apple Computer. The primary reason for releasing preliminary product information is to provide the developer community with essential product specifications, theory, and application information for the purpose of stimulating work on compatible third-party products.
Note
Information regarding Windows development software for the QuickTake 100 camera is supplied in this note to give developers an idea of the capabilities of the tools that will soon be available for Windows programmers.u
Contents of This Note
This developer note is divided into five chapters and three appendixes:
Chapter 1, “Introduction to the QuickTake 100 Camera,” gives a summary of the features of the QuickTake 100 digital computer camera.
Chapter 2, “QuickTake 100 Driver Software,” provides an overview of the QuickTake 100 device driver software and presents guidelines and some sample code for using the software to control the QuickTake 100. This chapter also describes the device control functions supported by the QuickTake 100 device driver for Macintosh and Windows-compatible computers.
Chapter 3, “QuickTake 100 Images,” provides information about the memory required for displaying the various QuickTake 100 image formats supported by the image processing software. It also lists the bit depths for the output formats.
Chapter 4, “Displaying QuickTake 100 Images in a Windows Application,” provides a high-level overview of image processing on a Windows-compatible computer. It also describes the Windows IPM DLL functions that support image processing. These functions are used for gathering information about images in the QuickTake 100 and displaying those images on the host computer.
Chapter 5, “Displaying QuickTake 100 Images in a Macintosh Application,” provides an overview of the QuickTime decompressor for image processing on the Apple Macintosh computer.
Appendix A, “QuickTake 100 Serial Interface,” includes information about the QuickTake 100 serial connector and supported serial protocols. It also provides two diagrams for building serial cables, one to connect a Macintosh computer to a QuickTake 100 camera and another to connect a Windows-compatible computer to a QuickTake 100.
Appendix B, “QuickTake 100 Camera Specifications,” lists the technical specifications for the QuickTake 100 camera.
An index is also included.
Supplementary Documents
To supplement the information in this developer note, Macintosh developers should have copies of the appropriate Apple reference manuals. The following documents are essential to Macintosh software development:
Technical Introduction to the Macintosh Family, third edition, surveys the complete Macintosh family of computers from the developer’s point of view.
Macintosh Human Interface Guidelines provides authoritative information about the theory behind the Macintosh “look and feel” and standard ways of using individual interface components.
Inside Macintosh is a collection of books, organized by topic, that describe the system software of Macintosh computers. Together, these books provide a comprehensive reference for Macintosh programmers, software designers, and engineers. The current volume titles are
Inside Macintosh: Overview
Inside Macintosh: Macintosh Toolbox Essentials
Inside Macintosh: More Macintosh Toolbox
Inside Macintosh: Files
Inside Macintosh: Processes
Inside Macintosh: Memory
Inside Macintosh: Imaging With QuickDraw
Inside Macintosh: Text
Inside Macintosh: Interapplication Communication
Inside Macintosh: QuickTime
Inside Macintosh: QuickTime Components
Inside Macintosh: Networking
Designing Cards and Drivers for the Macintosh Family, third edition, explains the hardware and software requirements for drivers and NuBus™ ‘90 accessory cards compatible with Macintosh computers.
To supplement the information in this developer note, Windows developers should have copies of the appropriate Microsoft Windows programming reference manuals. Microsoft Press is an excellent source for documentation that meets the needs of the Windows developer.
For More Information
APDA is Apple’s worldwide source for over three hundred development tools, technical resources, training products, and information for anyone interested in developing applications on Apple platforms. Customers receive the quarterly APDA Tools Catalog featuring all current versions of Apple development tools and the most popular third-party development tools. Ordering is easy; there are no membership fees, and application forms are not required for most of the products. APDA offers convenient payment and shipping options, including site licensing.
To order products or to request a complimentary copy of the APDA Tools Catalog, contact
APDA
Apple Computer, Inc.
P.O. Box 319
Buffalo, NY 14207-0319Telephone 800-282-2732 (United States)
800-637-0029 (Canada)
716-871-6555 (International)
Fax 716-871-6511
AppleLink APDA
America Online APDA
CompuServe 76666,2405
Internet APDA@applelink.apple.com
Typographical Conventions
This developer note uses typographical conventions that are standard in Apple publications.
All code listings and the names of the actual data structures, constants, fields, parameters, and routines are shown in Courier (this is Courier).
Hexadecimal numbers are preceded by a dollar sign ($). For example, the hexadecimal equivalent of decimal 16 is written as $10.
Note
A note like this contains information that is interesting but not essential for an understanding of the text.u
IMPORTANT
A note like this contains important information that you should read before proceeding.s
Introduction to the QuickTake 100 Camera
This chapter gives a summary of the features of the QuickTake 100 camera. An overview of how to use the features of the QuickTake 100 driver is provided in Chapter 2, “QuickTake 100 Driver Software.”
QuickTake 100 Overview
The QuickTake 100 is a portable, fully automatic, hand-held digital computer camera. It stores compressed 24-bit color still images in internal memory. Images are captured using the same process used to take pictures with any hand-held camera—aim at your subject and press a button to open the shutter and take a picture. The internal memory in the camera acts like a roll of film that stores the images by number. In addition to manual control, the QuickTake 100 can also be controlled over a serial cable by a host computer using the software described in this developer note.
The QuickTake 100 provides a simple solution for capturing and transferring digital images to a host computer. Using a serial interface, images captured in the camera can be retrieved by the host computer without the need of an intermediary digitizing device, such as a scanner or frame-capturing video card. The QuickTake 100 serial port is described in Appendix A, “QuickTake 100 Serial Interface.”
QuickTake 100 images are captured in two user-defined pixel resolutions—640 by 480 and 320 by 240. Images with 640 by 480 pixels are referred to as high-resolution images. Images with 320 by 240 pixels are referred to as standard-resolution images. The QuickTake 100 camera has a 1 MB memory area for image storage and can store a total of 32 standard-resolution images, 8 high-resolution images, or a combination of the two.
In addition, a thumbnail image is stored with each image captured. A thumbnail image has a pixel resolution of 80 by 60. Thumbnail images are useful for previewing the contents of an image file.
The images are stored in the camera in a compressed format that cannot be readily used by the host computer. QuickTake 100 images must be retrieved from the camera with the QuickTake 100 driver DLL functions and then decompressed with the Image Processing Module (IPM) functions prior to displaying them within an application window.
On the Macintosh computer the IPM functions are incorporated into a QuickTake 100 QuickTime decompressor. Programs written for the Macintosh use the decompressor to decompress the compressed raw QuickTake 100 image data so that the image can be displayed on the Macintosh computer. Standard QuickTime compressor calls are used for the decompression and display process.
A Windows DLL provides the IPM for Microsoft Windows. Windows programs use the functions described in Chapter 4, “Displaying QuickTake 100 Images in a Windows Application,” to decompress and display the QuickTake 100 raw image data in an appropriate display format.
For a discussion of what your application needs to do to interact with the QuickTake 100 camera, see “Using the QuickTake 100 Driver Software” beginning on page 2-3.
QuickTake 100 Developer Software
The QuickTake 100 developer software is available for both Macintosh computers and Microsoft Windows compatible computers. The hardware and software required for developing QuickTake 100 applications on Macintosh and Windows platforms is listed in this section.
Macintosh
The QuickTake 100 driver and image processing software work with the following Apple Macintosh computer configurations:
n computers with a Motorola 68020 or greater CPU
n System 7.0.1• Tune-Up or a later version of system software
n 5 MB of RAM
The QuickTake Image QuickTime decompressor and the QuickTake 100 glue code and header files (CmDriver.c, CmDriver.h, and GeoPortErrors.h) are required to develop software that can recognize and can display QuickTake 100 images that have been saved on the Macintosh computer in the QuickTake 100 image format.
In addition to the QuickTake Image QuickTime decompressor system extension, the following software components, which must be installed using the Installer software on the QuickTake 100 disk set, are needed to develop software for connecting to the QuickTake 100 camera, taking pictures, retrieving pictures, and setting various operational paramaters of the camera:
n ColorSync version 1.0.3 and ColorSync Profiles—a control panel (provides screen chromaticity values)
n Foreign File Access—system extension
n GeoPortSerialDriver 1.0—a system extension (Shared Library Manager module)
n Network and associated Network Resources file—control panel
n QuickTake Access—system extension (Foreign File Access module)
n QuickTake Camera device driver—a system extension
n QuickTime version 1.6.1—a system extension
n Serial Extension—a system extension (Shared Library Manager module)
n Serial Switch version 1.1—for the Macintosh IIfx, Macintosh Quadra 900, and Macintosh Quadra 950 computers
n Shared Library Manager version 1.1.1 and associated Library Manager Resources file
The following application software is also on the disks that accompany the QuickTake 100 camera:
n QuickTake version 1.0—an application that provides an interface for connecting to the QuickTake 100 camera, taking pictures, retrieving pictures, saving pictures in several file formats, and setting operational paramaters of the camera
n QuickTake Setup—a control panel for mounting the camera on the desktop
Windows
The QuickTake 100 driver DLL and image processing DLL software work with the following Microsoft Windows configurations:
n Windows 3.1 or later
n Intel i80386, i80486, or greater CPU
n 4 MB of RAM
The following software components are required to create Windows-compatible applications for the QuickTake 100 camera:
n QuickTake 100 driver DLL and header file (QTAKE-D.DLL and QTAKE-D.H)
n QuickTake 100 IPM DLL and header file (QTAKE-I.DLL and QTAKE-I.H)
QuickTake 100 Features
The QuickTake 100 camera has many features that are easily controlled by the user. It also has an LCD display that provides visual feedback about various internal conditions.
User Controls
The QuickTake 100 camera has these user controls:
n power on and off
n flash button
n erase-all button
n timer button
n resolution button
n shutter button
These controls are described in the following sections.
Power On and Off
Power is on when the lens cover on the front of the camera is slid to one side, exposing the lens. Figure 1-1 shows the lens cover in the open position. At power-on time, the LCD display, shown in Figure 1-2, becomes active, and the flash is set to automatic. If the green light is on in the view finder, the camera is ready to take a picture.
Figure 1-1 QuickTake 100 lens cover in the open position
To turn the power off, close the lens cover. The picture resolution, number of pictures taken, and number of pictures available settings are stored after the power is turned off. Other settings return to the default values.
Figure 1-2 QuickTake 100 LCD display and user control buttons
Flash Button
A flash button toggles three flash settings—automatic flash, flash on, and flash off.
Automatic Flash
When power is on, the flash is set to automatic. When automatic flash is set, the QuickTake 100 camera determines when the flash is used according to the current light conditions. A green light in the view finder indicates the flash is fully powered and the camera is ready to take a picture.
Flash On
If the flash button is pressed while automatic flash is active, the flash-on setting becomes active. In the flash-on setting, the QuickTake 100 camera always uses the flash when a picture is taken. A green light in the view finder indicates the flash is fully powered and the camera is ready to take a picture.
Flash Off
If the flash button is pressed while flash on is active, the flash-off setting becomes active. In the flash-off setting, the QuickTake 100 camera does not use the flash. If the flash button is pressed while flash off is active, the automatic-flash setting becomes active.
Erase-All Button
When the recessed erase-all button is pressed, all of the images currently stored in the camera are erased. During the period of time that it takes for the images to be erased, the erase-all icon on the LCD display flashes. After the images are erased, the pictures-available indicator displays the number of available pictures for the current resolution setting and the pictures-taken indicator indicates zero pictures have been taken.
Timer Button
The timer button allows you to initiate a 10-second time delay before a picture is taken. Pressing the shutter button after the timer button is pressed causes a 10-second count to elapse before the shutter is actually opened. An indicator light on the top of the camera is on for 8 seconds and then flashes rapidly for 2 seconds prior to the shutter opening to take the picture. While the camera is in a timer sequence, no other features can be reset. You can’t cancel a timed picture sequence after the shutter button has been pressed by pressing the timer button a second time.
Resolution Button
The resolution button toggles between high-resolution and standard-resolution picture modes. The maximum number of pictures that can be taken is 8 in high-resolution mode and 32 in standard-resolution mode. (It takes more memory to hold more pixel data, so fewer pictures are available in high-resolution mode.)
The resolution setting also affects two indicators on the LCD display—the resolution icon and the pictures-available indicator. The effects that are particular to the display during different resolution settings are described in “LCD Display,” later in this chapter.
Shutter Button
The shutter button controls when a picture is taken. If the shutter button is pressed and the timer button has not been previously pressed, a picture is taken immediately. If the timer button has been pressed, a 10-second delay occurs prior to a picture being taken. When a picture is taken, the pictures-taken indicator on the LCD display increments by 1. The shutter button is disabled when there are zero pictures available in both high-resolution and standard-resolution picture modes.
LCD Display
The QuickTake 100 has an LCD display on the back of the camera to the right of the viewfinder, as shown in Figure 1-3.
Figure 1-3 Rear view of the QuickTake 100 camera
The LCD display provides information about the battery-power level, number of pictures taken, number of pictures still available, current picture-resolution mode, current flash setting, timer setting, and an erase-all pictures indicator. Icons or numbers on the display provide a visual representation for each of these conditions. The LCD display is activated when the QuickTake 100 camera is on.
Battery-Power Icon
The display indicates the current battery-power level with an icon of a battery. The icon indicates three conditions. A battery icon filled with black indicates a fully charged battery. A battery icon with only the right half filled with black indicates that the battery charge has dropped and the battery may need to be charged again soon. The battery icon flashes on and off to indicate that the battery needs to be charged immediately.
Pictures-Taken Indicator
The pictures-taken indicator is in the middle of the display. The count is incremented each time a picture is taken starting from 0 to the number of pictures taken.
Pictures-Available Indicator
The pictures-available indicator displays the number of pictures that remain to be taken in the current picture-resolution mode. This value decrements from 8 in high-resolution mode and decrements from 32 in standard-resolution mode. The pictures-available indicator is located next to the resolution icon on the LCD display.
If the resolution button is pressed when the QuickTake 100 camera is in the standard-resolution mode, the resolution mode changes to high resolution and the pictures-available indicator changes to indicate the current number of pictures that are available in high-resolution mode. The number decreases because high-resolution pictures consume larger amounts of image memory than standard-resolution pictures.
If the resolution button is pressed while the QuickTake 100 camera is in the high-resolution mode, the resolution mode changes to standard resolution and the pictures-available indicator changes to indicate the total number of pictures available in the standard-resolution mode. The number increases because standard-resolution pictures consume smaller amounts of image memory than high-resolution pictures.
If a picture is taken when the picture resolution setting is high resolution and the total number of pictures available indicates one picture, the pictures-available indicator displays 0 for one second. After one second elapses, the resolution setting is changed to standard resolution and the appropriate number of pictures available for standard resolution is indicated. If the resolution button is pressed at this point, the resolution changes back to high resolution and the number of pictures available changes to 0 for one second. After one second elapses, the resolution once again changes to standard and the appropriate number of pictures available in the standard-resolution mode is displayed.
QuickTake 100 Driver Software
This chapter presents an architectural overview of the QuickTake 100 driver software, provides basic guidelines for programming applications to control the QuickTake 100 camera and retrieve images stored in the camera memory, describes the driver functions, and includes a sample code listing that shows how you could use the driver functions in a Macintosh application to retrieve an image from the QuickTake 100 camera.
QuickTake 100 Device Driver Overview
The QuickTake 100 device driver includes a library of functions that are designed to facilitate control of the QuickTake 100 camera for taking pictures and retrieving picture images stored in the QuickTake 100 camera. This library of functions effectively hides the device-specific details that are otherwise required to enable an application to perform the tasks.
The functions in the library can be categorized as follows:
n Driver initialization functions. The functions in this category allocate and deallocate data structures used by the QuickTake 100 device driver.
n Camera connection functions. The functions in this category are used to identify and connect to a camera.
n Camera control functions. The functions in this group are used to retrieve, set, or control various characteristics of the QuickTake 100 camera, for example, to retrieve information about a particular picture in the camera, to set the flash mode, or to erase the pictures stored in the camera.
n Image retrieval and capture functions. The functions in this group are used to retrieve images and take pictures.
For the Windows platform, the driver is provided in the form of a dynamic link library (DLL).
For the Macintosh platform, the device driver is provided in the form of a QuickTake 100 system extension.
All QuickTake 100 driver functions return a result code to notify the caller that the function has successfully completed or to provide a reason if the function is not successful. A result code of 0 (zero) always indicates successful completion.
The include file CmDriver.h defines the constants for each error status. Errors also appear in the “Result Codes” section for each function description.
If the value returned by a function indicates an error and if the error was detected by the camera, then further information is available through a call to the CmGetErrorInfo function. For information about errors detected by the camera, see the CmGetErrorInfo function described on page 2-48.
Using the QuickTake 100 Driver Software
To interact with the QuickTake 100 camera, applications must perform these steps:
1. Open the QuickTake 100 device driver.
2. Establish a connection.
3. Retrieve or capture images.
4. Close the connection.
5. Close the QuickTake 100 device driver.
Initializing the QuickTake 100 Device Driver
Your application must first initialize the QuickTake 100 device driver by making a call to the CmOpenDriver function. CmOpenDriver allocates and initializes internal structures required by the driver to successfully perform any operations requested by subsequent calls.
On the Macintosh platform, CmOpenDriver also initializes and opens the QuickTake 100 driver. The CmOpenDriver function is described on page 2-20.
Establishing a Connection With the Camera
After initializing the QuickTake 100 device driver, your application must identify the camera to be controlled before making a connection to it. This is performed by calling the CmGetPortInfo function to determine whether a camera is attached to the host. If a camera is attached to the host, then call CmConnect to make a connection with that camera.
The CmGetPortInfo function returns a CmPortInfo data structure that contains, among other things, information about the current status and availability of a camera attached to the specified serial port.
After you determine that a serial port has a camera attached to it and that the camera is available, you then call the CmConnect function with a handle to the CmPortInfo structure for the camera. If more than one camera is attached, you should provide a dialog box that asks the user which camera he or she would like to connect with.
The CmConnect function establishes a connection with the camera specified in CmPortInfo. CmConnect and CmPortInfo should be called once for each communication session with a QuickTake 100 camera. See the descriptions of the CmGetPortInfo function on page 2-22, the CmConnect function on page 2-25, and the CmDisconnect function on page 2-27 for additional information about connecting to a QuickTake 100 camera. See the description of CmPortInfo on page 2-10.
IMPORTANT
IMPORTANT
Although an application may call CmGetPortInfo successively on as many serial ports as there are available on the host computer, the driver can interact with only one QuickTake 100 camera at a time.s
Capturing and Retrieving Images
After the driver is initialized and the connection is made with the QuickTake 100 camera, the application can interact with camera to perform the following tasks:
n Get the current status of the camera by calling the CmGetCameraInfo function. The status information returned by this function includes the number of pictures that have been taken, the number of pictures that can be taken, camera battery status, and so on. Refer to the description of the CmGetCameraInfo function on page 2-28.
n Get information related to a particular image in the camera by calling the CmGetPictureInfo function. The information returned by this function includes the size, in bytes, of the image corresponding to the picture; the image width and height, in pixels; the date and time the picture was taken; and so on.
n Retrieve the image by issuing CmGetThumbnailImage (for the thumbnail version) or CmGetFullSizeImage (for either the standard-resolution or high-resolution version).
n Capture an image by calling CmTakePicture, optionally preceded by calls to such functions as CmSetFlashMode, CmSetPictureMode, and possibly CmErase.
For more information, see the descriptions of CmGetCameraInfo on page 2-28, CmGetPictureInfo on page 2-29, CmGetThumbnailImage on page 2-54, CmGetFullSizeImage on page 2-57, CmSetFlashMode on page 2-42, CmSetPictureMode on page 2-41, and CmErase on page 2-31.
Closing the Camera Connection
After your application has finished interacting with the camera, it must declare its intention to end the session with the camera by calling CmDisconnect and CmDisposePortInfo. Since the CmConnect function establishes an implicit connection with a camera within which the driver functions work, your application must first end any current connection before it is able to establish a connection and interact with other cameras, if any, connected to the host computer.
After your application has closed the current camera connection, it may open a new connection with the same camera or other cameras connected to the host as described in “Establishing a Connection With the Camera,” earlier in this chapter.
For more information, see the descriptions of CmDisconnect on page 2-27 and CmConnect on page 2-25.
Closing the QuickTake 100 Device Driver
After your application has finished whatever it had to do with the QuickTake 100 device driver and disconnected from any camera with which it was interacting , it must call the function CmCloseDriver. This function frees the internal structures used by the driver.
On the Macintosh platform, CmCloseDriver closes the camera driver.
For more information, see the description of CmCloseDriver on page 2-21.
Sample Code for Retrieving an Image From the Camera
Listing 2-1, for the Macintosh computer, shows a function called GetImage that uses the QuickTake 100 device driver functions to retrieve an image from the QuickTake 100 camera.
Listing 2-1 Using the device driver functions to retrieve an image from the QuickTake 100 camera
#include "CmDriver.h"
#define kGenericErr -1
OSErr GetImage(unsigned short imageNumber, Handle *imageBuffer,
unsigned long *imageSize)
{
OSErr err;
CameraData camData;
CmPortInfoHandle portInfoHandle;
unsigned long portIndex;
CmPictureInfo *pictureInfo;
Boolean firstRead;
unsigned long actualBytes;
/* Open the QuickTake 100 camera driver with CmOpenDriver. */
err = CmOpenDriver(&camData);
if (err != noErr || camData == NULL)
return err;
/*
Use CmGetPortInfo to find a QuickTake 100 camera on a serial port.
On the Windows platform, each of the functions CmTakePicture, CmGetThumbnailImage, CmGetFullSizeImage, and CmErase has an asynchronous counterpart whose name is derived by appending the word Async at the end of the function name (for example, CmTakePictureAsync). On the Macintosh platform, the functions CmErase and CmTakePicture have asynchronous counterparts. The goal of the asynchronous set of functions is to allow applications to have a separate thread of execution when performing these functions with the QuickTake 100 camera. The asynchronous functions allow the user to perform other operations, such as typing or editing text, during the time in which a picture is being transferred from the camera to the host computer.
The means by which the different threads synchronize their execution is supplied by your application in the form of a completion routine for each of the asynchronous functions. The completion routine CmAsyncCompletionRoutine is shown here:
For a complete description of how to use the application-defined completion routine, see the definition on page 2-33.
Although the asynchronous functions do provide a means by which an application can receive progress information from an operation asynchronously, neither Windows nor the Macintosh Finder acts as a preemptive multitasking architecture. It is still the responsibility of the application to implement the callback routines within the confines of the respective operating-system environment.
Note
The asynchronous functions CmGetThumbnailImageAsync and CmGetFullSizeImageAsync are not available on the Macintosh platform.u
Note
All of the asynchronous functions CmGetThumbnailImageAsync, CmGetFullSizeImageAsync, CmTakePictureAsync, CmEraseAsync, and CmCancelAsyncOperation are supported by the Windows QuickTake 100 DLL. CmTakePictureAsync and CmEraseAsync are the only asynchronous functions supported on the Macintosh platform.u
QuickTake 100 Device Driver Reference
The device driver reference defines all of the data types and functions supported by the QuickTake 100 device driver.
Data Types for the QuickTake 100 Device Driver Functions
This section describes all of the data types referenced by the QuickTake 100 device driver functions. The definitions are found in the CmDriver.h file for Macintosh programs and in the QTAKE-D.H file for Windows programs.
CameraData
The CameraData data type is native to the Macintosh programming environment and defined as
typedef CmCameraData* CameraData;
For the Windows environment it is defined as
typedef unsigned short CameraData;
All QuickTake 100 device driver functions require a data item of this type as their first parameter, except CmOpenDriver, which expects the address of a data item of this type.
For Windows, the parameter must be the handle of the application program (the variable that Windows gives to your application as the first parameter to WinMain). WinMain and other items specifically referenced by Windows application programs are described in the documentation that accompanies the software programming environment with which Windows applications are created.
For the Macintosh computer, this parameter must be the pointer whose address is handed to CmOpenDriver.
BufferPtr
The BufferPtr data type is a pointer to an address containing information to be used by a function or an address used to receive information returned by a function.
For the Macintosh platform BufferPtr is defined as
typedef unsigned char* BufferPtr;
For the Windows platform BufferPtr is defined as
typedef unsigned char far* BufferPtr;
Note
Windows applications should not use the BufferPtr type as it is defined here when making a call to the CmGetFullSizeImage function, described on page 2-57, if the buffer required for the image is greater than 64KB. Instead, use type coercion to change the BufferPtr type of the imageBuffer parameter to unsigned char huge*. u
SEE ALSO
CmGetThumbnailImage on page 2-54, CmGetThumbnailImageAsync on page 2-56, CmGetFullSizeImage on page 2-57, CmGetFullSizeImageAsync on page 2-60, CmSetOwnerName on page 2-40, and CmGetDecompTable on page 2-45.
CmStdFeatures
The CmStdFeatures structure provides information about the version of the Macintosh QuickTake 100 driver or Windows DLL.
typedef struct {
short version;
} CmStdFeatures, *CmStdFeaturesPtr;
Field descriptions
version Macintosh: The version number of the QuickTake 100 driver
Windows: The current version of the DLL
SEE ALSO
CmGetStdFeatures on page 2-35
CmPortInfo
The CmPortInfo structure contains information about a QuickTake 100 camera that is attached to a host serial port. When you make a call to the CmConnect function to establish a connection with a QuickTake 100 camera, you pass the CmPortInfo structure for the port and camera with which you want to connect.
You retrieve the CmPortInfo structure for a specified serial port with the CmGetPortInfo function.
portIcon Handle of the icon representing this port.
portName Operating-system-specific name of this port. On the Macintosh it is a handle to a length-prefixed Pascal-style string. On the Windows platform it is a null-terminated C string.
portStatus The portStatus field contains one of these symbolic constants indicating the status of the port:
kGeoPortFree A GeoPort device is attached on this port and is ready to process commands from the host.
kPortFree A QuickTake 100 camera is attached on this port and is ready to process commands from the host.
kInUseByGeoPort A GeoPort aware application is using the serial port. The family ID, device ID, and beacon parameter will be returned in the familyID, deviceID, and beaconParam fields respectively.
kInUseBySerial Another serial application is using the serial port.
kInUseByUnknown Another serial application is using the serial port.
kInUseByLocalTalk The LocalTalk driver is using the serial port.
appName Null.
familyID The GeoPort family identification for digital image devices. When a QuickTake 100 camera is attached, this field contains the value 1 and has the constant name kCmFamilyID.
deviceID The GeoPort device identification for the camera. When a QuickTake 100 camera is attached, this field contains the value 1 and has the constant name kCmDeviceID.
beaconParam The GeoPort beacon parameter of the QuickTake 100 camera. This value is 256.
portConfig Operating system dependent. Reserved.
DataSpeed The data transfer rate in bits per second of this port. Before an actual camera connection is made, the value of this field is 0. After the connection is made, this field contains the appropriate value for the data transfer rate. See the description of the CmGetPortInfo function on page 2-22 and CmConnect function on page 2-25 for more information about data transfer speed.
SEE ALSO
CmConnect on page 2-25, CmGetPortInfo page 2-22, CmDisposePortInfo on page 2-24
CmProductInfo
The CmProductInfo structure provides product-specific information about the QuickTake 100 camera.
typedef struct {
char vendorName[8];
char productIdentification[16];
unsigned char hardwareVersion[2];
unsigned char firmwareVersion[2];
} CmProductInfo, *CmProductInfoPtr;
Field descriptions
vendorName An 8-byte ASCII string containing the name of the camera vendor.
productIdentification
A 16-byte ASCII string containing the product name.
hardwareVersion Hardware version of the camera:
Byte 0 contains the major version number.
Byte 1 contains the minor version number.
firmwareVersion Firmware version of the camera:
Byte 0 contains the major version number.
Byte 1 contains the minor version number.
SEE ALSO
CmGetProductInfo on page 2-37.
CmDateAndTime
The CmDateAndTime structure contains the current date and time of a specified QuickTake 100 camera.
typedef struct {
unsigned char month;
unsigned char day;
unsigned char year;
unsigned char hour;
unsigned char minute;
unsigned char second;
} CmDateAndTime, *CmDateAndTimePtr;
Field descriptions
month Month of the year. Number in the range 1 through 12.
day Day of the month. Number in the range 1 through 31.
year Last two digits in the year of the century. For example, a value of 93 means the year 1993 (can also mean 2093). Number in the range 0 through 99.
hour Hour of the day. Number in the range 0 though 23 (24-hour base; for example, 2:00 P.M. is 14.).
minute Minute of the hour. Number in the range 0 through 59.
second Second of the minute. Number in the range 0 through 59.
SEE ALSO
CmSetDateAndTime on page 2-39, CmGetCameraInfo on page 2-28, CmGetPictureInfo on page 2-29
CmInterface
The CmInterface structure defines the communication parameters for the QuickTake 100 camera attached to a host running Windows. This structure is one of the fields in the CmCameraInfo structure defined on page 2-14.
typedef struct {
unsigned char transferRate;
unsigned char configuration;
unsigned char timeOut;
} CmInterface;
Field descriptions
transferRate Indicates the data transfer rate between the host and the camera.The transfer rate in bits per second (bps) is calculated by multiplying 1200 by the value of this field. For example, a value of 2 indicates 2400 bps.
configuration Indicates the serial communication settings. It contains 8 bits MSB-LSB as follows: parity (2 bits), stop bits (1 bit), data length (2 bits), unused (3 bits).
Parity Stop bits Data length
00 = None 0 = 1 bit 10 = 7 bits
01 = Odd 1 = 2 bits 11 = 8 bits
11 = Even
A value of 11011000 would indicate even parity, 1 stop bit, 8 data bits.
timeOut Indicates the timeout period beyond which the camera decides that the host timed out. The actual timeout period is ten times the returned value (10 x timeOut) milliseconds. A timeOut value of 0 indicates no timeout. This value is implicitly set to 255, which is approximately 2.5 seconds.
CmCameraInfo
The CmCameraInfo structure contains detailed information about the specified QuickTake 100 camera and imaging parameters.
typedef struct {
unsigned char batteryStatus;
unsigned short noPicturesTaken;
unsigned short noPictureImageAvailable;
unsigned short fullImageWidth;
unsigned short fullImageHeight;
unsigned short thumbnailImageWidth;
unsigned short thumbnailImageHeight;
CmDateAndTime cameraDateAndTime;
unsigned char flashMode;
unsigned short exposureTime;
unsigned short FNumber;
unsigned char pictureMode;
unsigned char reserved
unsigned char fullImageDatCompMode;
unsigned char thumbImageDatCompMode;
unsigned long totalMemorySize;
unsigned long freeMemorySize;
char ownerName[32];
unsigned char CCDSensorType;
CmInterface hostInterface; /* Windows only */
unsigned char cameraInformationBytes[6];
unsigned char compDecompParamVersion[4];
unsigned char colorMatrixVersion[4];
unsigned char spareImageMemoryBlock;
unsigned short noBasePicturesTaken;
unsigned short noQuarterPicturesTaken;
unsigned char sleepDelay;
} CmCameraInfo, FarPointer CmCameraInfoPtr;
Field descriptions
Field descriptions
batteryStatus Battery charge and battery icon indicator. Five constants are used to specify the current charge condition of the camera batteries and related condition of the battery icon in the LCD display. The constants have the following values:
kPowerAdapter = 140 Adapter is connected to the camera.
kBatteryRangeFull = 95
Battery is fully charged; the battery icon in the LCD display is full and the adapter is not connected.
kBatteryIconFull = 86
Values greater than or equal to 86 show a battery icon in the LCD display that is full; the adapter is not connected.
kBatteryIconHalf = 80
Values between 85 and 80 indicate that the battery is half charged; the battery icon in the LCD display is half full and the adapter is not connected.
kBatteryRangeEmpty = 75
Battery has an insufficient charge for camera operation; the battery icon in the LCD display is empty and the adapter is not connected.
noPicturesTaken Number of pictures that have been taken since camera image memory was last cleared.
noPictureImageAvailable
Number of pictures that can be taken. This value is based on the current pictureMode setting of the camera.
fullImageWidth Number of pixels in the image width.
fullImageHeight Number of pixels in the image height.
thumbnailImageWidth Number of pixels in the thumbnail image width.
thumbnailImageHeight
Number of pixels in the thumbnail image height.
cameraDateAndTime Date and time maintained by the camera. This value can be changed with the CmSetDateAndTime function. See also the CmDateAndTime data structure described on page 2-12.
flashMode The flash mode of the camera.
0 = Automatic flash mode
1 = Never use flash
2 = Always use flash
The flash mode can be modified with the CmSetFlashMode function described on page 2-42.
exposureTime Indicates the exposure time that would be required to take a picture at the time of a CmGetCameraInfo function call. The value is the inverse of the actual exposure time. That is, exposure time is (1/exposureTime) seconds.
FNumber A function of focal length of the lens of the camera, its diameter, and the shutter speed. 28, 30, 35, 40, 49, 63, 90 and 160 are the possible values for FNumber.
pictureMode Specifies the image size of the picture to be taken.
16 = subsequent pictures will be high-resolution.
32 = subsequent pictures will be standard-resolution. This value can be changed with the CmSetPictureMode function described on page 2-41.
reserved Reserved.
fullImageDatCompMode
Method employed to compress image data in the camera. Always 1 adaptive differential pulse code modulation (ADPCM).
thumbImageDatCompMode
Method employed to compress thumbnail images. Always 3 (4 bits shifted to the right).
totalMemorySize Total size of memory available for picture storage in number of bytes.
freeMemorySize Remaining memory available for picture storage in number of bytes.
ownerName This field contains the identification of the owner of the camera. It is 32-bytes in length. The maximum number of characters in the owner name is 26, pad to 32 bytes with space characters. The owner name is set with the CmSetOwnerName function described on page page 2-40.
CCDSensorType Type of CCD (charged couple device) sensor.
0 = Kodak M7-L
1 = Kodak M7
hostInterface Serial communication parameters (only valid for Windows). This field is valid only if the underlying communication device is the standard serial interface. The parameter values are contained in the transferRate, configuration, and timeOut fields in the CmInterface structure described on page 2-13.
cameraInformationBytes
Reserved.
compDecompParamVersion
The version number of the set of ADPCM compression parameters employed by the camera.
colorMatrixVersion The version number of the color correction matrix employed by the camera. Bytes 0 and 1 together are the major version number. Bytes 2 and 3 together are the minor version number. See the description of the CmColorMatrix data structure on page 2-19.
Since the color matrix and image compression schemes in the camera may change in the future, it is always important to check the version number of the color matrix. You must make adjustments in your image processing setup, based on the version number of the color matrix in the camera as follows:
On the Windows platform, if the color matrix in the camera is version 1, use the default color matrix in the Windows IPM and pass that matrix back to the IPM for image processing. If it is not version 1, pass the color matrix returned by the camera to the IPM. See Chapter 5, “Displaying QuickTake 100 Images in a Macintosh Application” for more information about displaying images on the Windows platform.
On the Macintosh platform, if the color matrix is not version 1, get the color matrix from the camera, and fill in the color matrix field for the PICT QuickTake file definition passsed to the QuickTake QuickTime decompressor with the camera color matrix. If the version number is 1, process and display the images with the QuickTake decompressor using the same method you use for QuickTime PICT files. See Chapter 5, “Displaying QuickTake 100 Images in a Macintosh Application” for more information about displaying QuickTake images on the Macintosh computer platform.
spareImageMemoryBlock
Number of spare image blocks still available.
noBasePicturesTaken Number of high-resolution images that have been taken.
noQuarterPicturesTaken
Number of standard-resolution images that have been taken.
sleepDelay Sleep delay time of the camera. A numeric value in the range 0 through 5:
0 = Immediate
1 = 5 minutes
2 = 15 minutes
3 = 30 minutes
4 = 60 minutes
5 = Never sleep
SEE ALSO
CmGetCameraInfo on page 2-28, CmSetOwnerName on page 2-40, CmSetPictureMode on page 2-41, CmSetFlashMode on page 2-42, CmSetDateAndTime on page 2-39, IpGetCameraColorMatrix on page 4-16, IpSetCameraColorMatrix on page 4-17, IpInitCameraColorMatrix on page 4-17, IpCalculateColorTables on page 4-9
CmPictureInfo
The CmPictureInfo structure provides details about a specified image stored in the internal memory of the QuickTake 100 camera. Images are specified by picture number in the pictureNo parameter of the CmGetPictureInfo function.
typedef struct {
unsigned short pictureNo;
unsigned long imageDataSize;
unsigned short width;
unsigned short height;
CmDateAndTime dateAndTime;
unsigned char flashMode;
unsigned short exposureTime;
unsigned short FNumber;
unsigned char pictureMode;
unsigned char dataCompressionMode;
unsigned char defectiveFlag;
} CmPictureInfo, *CmPictureInfoPtr;
Field descriptions
pictureNo The picture number. This value is the second parameter passed to the CmGetPictureInfo function, which is described on page 2-29.
imageDataSize Size of the image in number of bytes.
width Width of the image in number of pixels.
height Height of the image in number of pixels.
dateAndTime Date and time that the image was captured.
flashMode A value indicating whether or not the flash was used:
0 = Flash not used
1 = Flash was used
exposureTime Indicates the exposure time that was required to take the specified picture. Value is (1/exposureTime) seconds.
FNumber The focal length of the lens of the camera, the diameter of the lens, and the shutter speed.
pictureMode Size of the image:
16 = High-resolution image
32 = Standard-resolution image
dataCompressionMode Data compression method:
1 = ADPCM high- and standard-resolution images
3 = Bit shift (4 bits to the right) thumbnail images
defectiveFlag Indicates a defect in the image data:
1 = One or more bad blocks of data
0 = Image is not corrupted
SEE ALSO
CmGetPictureInfo on page 2-29
CmColorMatrix
The CmColorMatrix data structure is provided for interface to the Image Processing Module to facilitate decoding of the image format employed by the camera.
typedef struct {
unsigned char colorMatrixVersion[4];
double colorCorrectionMatrix[12];
} CmColorMatrix, *CmColorMatrixPtr;
Field descriptions
colorMatrixVersion Version number of the color correction matrix returned in the colorCorrectionMatrix parameter. This is the same value that is returned in the colorMatrixVersion field of the CmCameraInfo data structure.
colorCorrectionMatrix
The color correction matrix. See the description of the Characteristics structure on page 4-6.
SEE ALSO
CmGetColorCorrectionMatrix on page 2-46
QuickTake 100 Device Driver Functions
This section defines all of the functions supported by the QuickTake 100 device driver. The QuickTake 100 device driver functions provide Macintosh and Windows application developers with a means to control the QuickTake 100 digital camera, gather image information from the camera, and set any user-definable parameters via software. To use the functions, you must include the CmDriver.h file in the include section of your Macintosh application code or the QTAKE-D.H file for Windows application code.
The functions are divided into groups:
n Driver initialization functions. The functions in this category allocate and deallocate data structures used by the device driver.
n Camera connection functions. The functions in this category are used to set up a connection with a camera.
n Camera control functions. The functions in this group are used to retrieve or set various characteristics of the QuickTake 100 camera (for example, the owner name).
n Image retrieval and capture functions. The functions in this group are used to retrieve images from the camera and take pictures.
Note
The numeric error codes provided in the Result Codes section of each function description are applicable to only Macintosh applications. Where errors apply to both Macintosh and Windows software, the symbolic constants are returned to Windows applications.u
Initializing and Closing the QuickTake 100 Device Driver
The functions in this category are CmOpenDriver and CmCloseDriver. These functions allocate and deallocate private data structures required by the QuickTake 100 driver.
cameraData Pointer to the private data allocated and returned by the QuickTake 100 device driver. This pointer must be passed to all the other QuickTake 100 driver functions as the first parameter.
For Windows: the address of a memory location that contains the application ID.
See “CameraData” on page 2-8 for more information about cameraData.
DESCRIPTION
The CmOpenDriver function initializes the driver by allocating and then initializing certain data structures that the driver uses upon subsequent function calls.
Note
During initialization on the Macintosh platform, application globals are saved via a call to SetCurrentA5. You can retrieve your application globals by subtracting 4 bytes from the parameter block pointed to in the A0 register. This is especially important for subsequent calls to application-defined completion routines during asynchronous operations. For more information about accessing application globals, see the chapter “Memory Management Utilities” in Inside Macintosh: Memory. For information about the completion routine for asynchronous functions, see the CmAsyncCompletionRoutine function described on page 2-33.u
IMPORTANT
Calling CmOpenDriver after the driver is open without a prior call to CmCloseDriver will result in an error.s
RESULT CODES
The CmOpenDriver function returns noErr on success. If an error occurs, it returns one of the values listed here:
kCmAlreadyOpenError -6202 The QuickTake 100 driver is already open.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item. Windows platform only.
kCmDriverNotLoadedError -6213 The camera device driver was not loaded at startup time. Macintosh platform only.
kCmNoMemoryError -6209 System failed to allocate memory.
kCmSystemError Windows DLL failed to either register its class or to create a window.
kSoftwareInstallErr -7945 Macintosh GeoPort error: The Shared Library Manager or GeoPort system extensions are missing.
memFullErr -108 Macintosh system error: Not enough memory for requested operation.
For the Macintosh, kCmAlreadyOpenError is also returned if another application has already opened the QuickTake 100 driver.
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
DESCRIPTION
This function frees the internal structures implicitly referenced by the functions.
Your application should call CmCloseDriver once when finished with the QuickTake 100 device driver and after it has disconnected from any camera with which it has been interacting.
IMPORTANT
Calling CmCloseDriver without a previous call to CmOpenDriver will result in a kCmNotOpenError error. A call to CmCloseDriver made prior to a call to CmDisconnect will not close the connection with the camera. Call CmDisconnect before CmCloseDriver to fully disconnect and close an open session with a camera. s
RESULT CODES
The CmCloseDriver function returns noErr upon successful completion. On error, the value returned by this function can be one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress. Macintosh platform only.
kCmBadArgError -6203 Parameter is or contains an address of an invalid data item.
kCmCurrentlyConnectedError -6205 The camera is connected and needs to be disconnected with CmDisconnect before calling CmCloseDriver.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
SEE ALSO
CmOpenDriver on page 2-20
Connecting With the Camera
The functions CmGetPortInfo, CmDisposePortInfo, CmConnect, and CmDisconnect are used to identify and connect to a camera so that the camera control functions described later in this chapter can be used.
CmGetPortInfo
pascal OSErr CmGetPortInfo(CameraData cameraData,
unsigned long index,
CmPortInfoHandlePtr portInfoHandle);
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
index Index number of a serial port:
Macintosh: 1 = Modem port
2 = Printer port
Windows: 1 through 9 for Comm 1 through Comm 9, respectively
portInfoHandle
Address of a memory location into which the handle of a CmPortInfo data structure is to be stored.
DESCRIPTION
CmGetPortInfo determines the presence and the availability of a camera at the end of a serial port on the host computer.
The driver defines each serial communication port with a number. The number is supplied to this function as the index parameter and is used by CmGetPortInfo to index into the array of serial ports available on the host computer.
The output of this function is a handle to the CmPortInfo data structure that contains, among other things, information as to whether the communication port corresponding to the given index number has a camera attached and, if it has, whether the attached camera is available for use by the current application. For information about the CmPortInfo data structure, see page 2-10.
The recommended way to use the CmGetPortInfo function is to call it multiple times, incrementing the index parameter by 1 for each call until kCmNoSuchPortError is returned on the Windows platform, or kNoPortErr is returned on the Macintosh platform. Your application code should be prepared to deal with a situation in which it discovers more than one available camera during the calling process. For example, you would provide a dialog box that allows the user to choose the camera with which they would like to make a connection.
The handle to the CmPortInfo structure returned by this function is supplied to CmConnect in the portInfoHandle parameter when you want your application to make a connection with the camera.
The value contained in the portStatus field of the CmPortInfo structure must be examined before a connection is actually made with the camera. The values in the portStatus field apply to the Windows and Macintosh platforms as follows:
The value kPortFree indicates that a camera is attached to the port and no application is currently connected to the camera. You can make a connection to the camera on that port if kPortFree is returned. The value kInUseByGeoPort indicates that a camera is attached to the port, but another application is currently connected to the camera.
When you call this function and find a camera that is available and currently not connected, the value in the DataSpeed field of the CmPortInfo structure returned by this function is 0. This is because the actual data transfer rate is not determined until a successful call to CmConnect has been completed. After a successful connection is made, the DataSpeed field in the CmPortInfo structure is updated with the correct data transfer rate.
IMPORTANT
This function returns kNoPortErr on the Macintosh platform or kCmNoSuchPortError on the Windows platform if the index parameter is specified as less than 1 or is greater than the number of serial ports available on the host computer. If the index parameter is specified as 0 the system error paramErr (-50) is returned on the Macintosh platform or kCmBadArgError on the Windows platform.
It is the responsibility of the application to free the memory area allocated by this function by calling the CmDisposePortInfo function to dispose of the data structure. s
RESULT CODES
Upon successful completion, CmGetPortInfo returns noErr, and the portInfoHandle parameter supplied to this function contains a valid handle of a CmPortInfo data structure corresponding to the serial port indexed by the index parameter.
If an error is detected, the portInfoHandle parameter contains NULL and CmGetPortInfo returns one of the values listed here:
kCmAIPError -6201 An asynchronous operation is already in progress. Macintosh platform only.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmCurrentlyConnectedError -6205 The camera is connected with an application.
kCmNoMemoryError -6209 System failed to allocate memory.
kCmNoSuchPortError -6210 Corresponding communication port does not exist. Windows platform only.
kCmNotOpenError -6211 The driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with the QuickTake 100 camera. Windows platform only.
kNoPortErr -7947 GeoPort error: Corresponding communication port does not exist. Macintosh platform only.
paramErr -50 Parameter is invalid. Macintosh platform only.
SEE ALSO
CmDisposePortInfo described next; CmConnect on page 2-25
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
portInfoHandle
Handle of the CmPortInfo structure to be freed.
DESCRIPTION
The CmDisposePortInfo function frees the CmPortInfo data structure and associated memory previously allocated by CmGetPortInfo.
It is the responsibility of the application to call this function when the CmPortInfo data structure is no longer needed.
IMPORTANT
Applications must dispose of the CmPortInfo data structure returned by CmGetPortInfo with the CmDisposePortInfo function before making a call to CmCloseDriver. s
RESULT CODES
Upon successful completion, CmDisposePortInfo returns noErr.
If an error is detected, CmDisposePortInfo returns one of the values listed here:
kCmAIPError -6201 An asynchronous operation is already in progress. Macintosh platform only.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCurrentlyConnectedError -6205 The camera is connected and needs to be disconnected with CmDisconnect before calling CmCloseDriver. Windows platform only.
kCmNotOpenError -6211 The driver has not been initialized.
SEE ALSO
CmGetPortInfo on page 2-22, CmCloseDriver on page 2-21
CmConnect
pascal OSErr CmConnect(CameraData cameraData,
CmPortInfoHandle portInfoHandle);
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
portInfoHandle
Handle of a CmPortInfo structure that has been allocated and returned by a previous call to CmGetPortInfo.
DESCRIPTION
The CmConnect function is used to establish a connection with a camera. After a connection is made, the QuickTake 100 device driver functions can be used to control the camera.
On the Macintosh computer the connection is a high-speed serial connection. In a Windows environment the CmConnect function determines the fastest speed at which the host and camera can communicate and selects that speed.
IMPORTANT
IMPORTANT
An application can connect with only one camera at a time.
Although an application may allocate more than one CmPortInfo structure by making multiple calls to the CmGetPortInfo function, a kCmCurrentlyConnectedError error will result if that application tries to connect with more than one camera. s
Note
In the Windows software environment CmConnect determines the data transfer speed at which the QuickTake 100 camera and the host communicate. Therefore, the value in the DataSpeed field of portInfoHandle returned by a call to the CmGetPortInfo function is not valid until after a successful call to CmConnect.
If communication errors are detected during image data transfers in the Windows environment, the cause may be the transfer speed set at the time the connection with the camera is made. To correct this situation, Windows applications can create an Windows initialization file (INI file) that limits the upper threshold for serial communication with the QuickTake 100 camera.
The INI file must be in the Windows root directory and be named QTAKE-D.INI. The file must contain the section [QTake1-D] as follows:
[QTake1-D]
MaxBaudRate = nnn
where nnn is a value that determines the upper threshold for data transfer speed. Allowable values are 9600, 19200, 38400, and 57600. For Windows, the CmConnect function uses 57,600 as the default upper threshold when determining the data transfer speed. If a problem exists during data transfer from the camera, use a lower value for MaxBaudRate in the QTAKE-D.INI file.u
RESULT CODES
Upon successful completion, CmConnect returns noErr.
If an error is detected, this function returns one of the values listed here:
kCmAIPError -6201 An asynchronous operation is already in progress. Macintosh platform only.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCurrentlyConnectedError -6205 The camera is already connected.
kCmCameraNotFoundError -6206 Camera not found on this port. Windows platform only.
kCmHandshakeError -6207 Initial handshake with the camera has failed. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with the camera. Windows platform only.
kNoPodErr -7937 Camera not found on this port. Macintosh platform only.
This function returns kCmBadArgError if values in the familyID and deviceID fields in the CmPortInfo structure are other than the global constants kCmFamilyID and kCmDeviceID, respectively. This function also returns kCmCameraNotFoundError if the familyID and deviceID fields are not correct.
For Windows applications, CmConnect also updates the dataSpeed field of the CmPortInfo structure with the actual data transfer rate that has been set for subsequent communication with the camera.
SEE ALSO
CmGetPortInfo on page 2-22; CmDisconnect, described next
CmDisconnect
pascal OSErr CmDisconnect(CameraData cameraData);
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
DESCRIPTION
The CmDisconnect function ends the connection with the camera that was previously established by CmConnect.
An application should call CmDisconnect whenever it has finished interacting with a camera. Applications must also call this function before connecting with a camera other than the one with which there is a current connection. After the CmDisconnect function has successfully returned, the application can then make another call to CmConnect to establish a new connection for the camera.
The CmDisconnect function terminates any outstanding asynchronous operation with a call to CmCancelAsyncOperation on the Windows platform. On the Macintosh platform, PBKillIO is called to cancel the operation. The callback routine for the canceled asynchronous function will also be called.
IMPORTANT
An application should not call CmCloseDriver while a camera connection is active. Call CmDisconnect to end the camera connection and then call CmCloseDriver.s
RESULT CODES
This function returns noErr on success.
On error, this function returns one of the values listed here:
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
SEE ALSO
CmConnect on page 2-25, CmCloseDriver on page 2-21
Controlling the Camera
The functions in this group are used to retrieve or set various characteristics of the QuickTake 100 camera, for example, getting or setting the camera owner name.
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
cameraInfo
Pointer to an area large enough to hold an entire CmCameraInfo structure.
DESCRIPTION
The CmGetCameraInfo function retrieves information related to the QuickTake 100 camera. The information is returned in the form of a CmCameraInfo data structure, described on page 2-14.
RESULT CODES
Upon successful completion, the CmGetCameraInfo function returns noErr and the area pointed to by the cameraInfo parameter contains the CmCameraInfo data structure corresponding to the currently connected camera.
Upon failure, this function returns one of the values listed here. Note that in these error cases the content of the area pointed to by cameraInfo is not affected.
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
Note
Applications must allocate an area of memory large enough to hold the entire CmCameraInfo structure or an error may occur.u
SEE ALSO
CmGetPictureInfo, described next; CmGetErrorInfo on page 2-48
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
pictureNo The number that identifies a particular picture stored in the internal memory of the camera.
pictureInfo
Pointer to an area of memory large enough to hold an entire CmPictureInfo structure.
DESCRIPTION
The CmGetPictureInfo function retrieves information related to a particular picture image stored in the internal memory of the camera. The information is in the form of a CmPictureInfo data structure, which is described on page 2-18.
Each image stored within the internal memory of the QuickTake 100 camera has a numeric value associated with it. This number is referred to as the picture number. Essentially, the camera uses numbers to name the images that have been captured. The numbers are assigned in chronological order, with the first picture taken numbered 1, the next picture taken numbered 2, and so on. It is the picture number that is specified in the pictureNo parameter.
The picture numbering sequence starts again at the number 1 after a successful call to either the CmErase or the CmEraseAsync function.
RESULT CODES
Upon successful completion, the CmGetPictureInfo function returns noErr and the area pointed to by the pictureInfo parameter contains the CmPictureInfo structure corresponding to the picture identified by the pictureInfo parameter.
If an error is detected, the value returned is one of those listed here. Note that in this case the content of the area pointed to by pictureInfo is unaffected.
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmGetCameraInfo on page 2-28, CmGetThumbnailImage on page 2-54, CmGetFullSizeImage on page 2-57, CmGetErrorInfo on page 2-48
CmErase
pascal OSErr CmErase(CameraData cameraData);
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
DESCRIPTION
The CmErase function erases all of the images that have been stored in the internal memory of the camera. After a successful call to CmErase, the picture numbering sequence restarts with the number 1.
Note
If errors are not detected, the CmErase function completes successfully and returns noErr, even if the currently connected camera does not contain any images to erase.u
RESULT CODES
Upon successful completion, this function returns noErr.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
asyncCompletionRoutine
Address of a callback routine to call when all the pictures stored in the internal memory of the currently connected camera have been erased.
DESCRIPTION
The CmEraseAsync function is the asynchronous version of the CmErase function and is provided for applications that pursue a different thread of execution during the time the pictures stored in the camera are being erased.
When the operation completes, the QuickTake 100 driver calls the CmAsyncCompletionRoutine supplied as the asyncCompletionRoutine parameter to this function (see the description of CmAsyncCompletionRoutine on page 2-33).
For Windows applications, the address of the callback routine handed to this function must be the one returned by the Windows function MakeProcInstance.
IMPORTANT
Applications should not attempt to call any other QuickTake 100 driver control functions including this function before the application-defined callback function CMAsyncCompletionRoutine is called by the QuickTake 100 driver.s
Windows applications cannot cancel the CmEraseAsync function by calling CmCancelAsyncOperation.
RESULT CODES
Upon successful completion, the CmEraseAsync function returns noErr.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCantCancel Currently outstanding asynchronous operation cannot be canceled. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
SEE ALSO
CmAsyncCompletionRoutine, described next; CmCancelAsyncOperation on page 2-34; CmErase on page 2-31; CmTakePictureAsync on page 2-62; CmRestoreDefaults on page 2-38
The CmAsyncCompletionRoutine completion routine enables an application to receive notification of the completion of an asynchronous operation. The application provides one or more implementations of the CmAsyncCompletionRoutine function and passes the address of the function as the last parameter to the asynchronous functions CmGetThumbnailImageAsync (Windows platform only), CmGetFullSizeImageAsync (Windows platform only),
CmTakePictureAsync, and CmEraseAsync.
When any of these asynchronous functions completes its respective operation, the QuickTake 100 driver calls the callback routine.
Note
For Windows applications, the address of the callback routine handed to an asynchronous function must be the one returned by the Windows function MakeProcInstance.u
The method by which the asynchronous call status and bytes transferred (where applicable) are provided to the application differs for the host platforms.
For the Windows platform:
The gsAsyncStatus global variable contains the value returned by the synchronous version of each of the asynchronous functions.
The gulAsyncNBytes global variable is valid only for the functions CmGetThumbnailImageAsync and CmGetFullSizeImageAsync and contains the number of bytes that have actually been transferred to the image buffer allocated for those calls.
Note
The values of the global variables gsAsyncStatus and gulAsyncNBytes are valid only during the time that the CmAsyncCompletionRoutine function is called in response to the completion of an asynchronous operation.u
For the Macintosh platform: A5 globals are saved into a long data type field in the CmCameraData structure when the driver is initially opened. The field is located before the parameter block field, which is also in the data structure. When your completion routine is called, a pointer to the parameter block field can be found at A0 and the result code in D0. You can access the A5 globals by subtracting 4 bytes from the address in A0.
RESULT CODES
A value of noErr indicates that the asynchronous function completed successfully; otherwise, an error occurred and you should call the CmGetErrorInfo function for additional information.
If the asynchronous function was canceled by the user in a Windows application, then the camera returns the camera error and detail code pair kCmErAttention and kCmErCommandAborted when the CMGetErrorInfo function is called.
On the Macintosh platform, PBKillIO is called. The kCmdTimeOut GeoPort error and kCmCameraError are returned, but no additional error detail codes are returned to the CmGetErrorInfo function. See the description of the CmGetErrorInfo function on page 2-48 for details about error return values.
SEE ALSO
CmGetThumbnailImageAsync on page 2-56, CmGetFullSizeImageAsync on page 2-60, CmTakePictureAsync on page 2-62, CmEraseAsync on page 2-32, CmGetErrorInfo on page 2-48, and CmCancelAsyncOperation, described next
CmCancelAsyncOperation
pascal OSErr CmCancelAsyncOperation
(CameraData cameraData);
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
DESCRIPTION
The CmCancelAsyncOperation function provides a method for Windows applications to cancel either a CmGetThumbnailImageAsync function call or a CmGetFullSizeImageAsync function call that is currently outstanding.
The callback routine corresponding to the canceled operation is called by the QuickTake 100 driver before this function returns. The global variable gsAsyncStatus that corresponds to the callback routine for the canceled operation will contain the error and detail code pair kCmErAttention and kCmErCommandAborted. See the description of the CmGetErrorInfo function on page 2-48 for details about error return values.
This function returns kCmCantCancel if called while either a CmEraseAsync function call or a CmTakePictureAsync function call is outstanding.
Note
This function is available only for the Windows platform.u
RESULT CODES
The CmCancelAsyncOperation function returns noErr if the currently outstanding asynchronous operation has successfully been canceled.
If an error is detected, the value returned is one of the following:
kCmANIPError -6203 No asynchronous operation is outstanding.
kCmCantCancel Currently outstanding asynchronous operation cannot be canceled.
kCmCommError -6214 A serial communication error occurred.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
SEE ALSO
CmGetThumbnailImageAsync on page 2-56, CmGetFullSizeImageAsync on page 2-60, CmTakePictureAsync on page 2-62, CmEraseAsync on page 2-32, CmAsyncCompletionRoutine on page 2-33
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
stdFeaturesPtr
Pointer to a memory location to be filled with the standard features of the underlying device driver.
length Length of the area pointed to by the stdFeaturesPtr parameter. This is the length in bytes of the amount of information you require from the CmStdFeatures structure, which is described on page 2-10.
DESCRIPTION
The CmGetStdFeatures function retrieves the version number of the underlying QuickTake 100 device driver or Windows DLL.
IMPORTANT
If the length parameter is less than the size of the CmStdFeatures data structure, the CmGetStdFeatures function truncates the data that it returns beyond length bytes specified.s
Note
The length parameter exists primarily for a future enhancement to the number of features available to the application.u
RESULT CODES
Upon successful completion, the CmGetStdFeatures function returns noErr and the area pointed to by the stdFeaturesPtr parameter is filled with the standard features data structure of the underlying device driver.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress. Macintosh platform only.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made. Windows platform only.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
SEE ALSO
CmGetProductInfo, described next; CmGetErrorInfo on page 2-48
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
productInfo
Address of a memory area to which this function returns the product information, a CmProductInfo data structure, for the camera currently connected.
DESCRIPTION
The CmGetProductInfo function returns the CmProductInfo data structure related to the currently connected camera. See the description of the CmProductInfo data structure on page 2-12.
RESULT CODES
Upon successful completion, CmGetProductInfo returns noErr and the area pointed to by productInfo contains the CmProductInfo product information data structure particular to the camera currently connected. See the description of the CmProductInfo data structure on page 2-12.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmGetStdFeatures on page 2-35, CmGetErrorInfo on page 2-48
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
DESCRIPTION
The CmRestoreDefaults function resets some of the characteristics of the currently connected camera to their factory settings. The characteristics that are reset to the factory settings are
Item Default value
Image size High-resolution
Image width in pixels 640
Image height in pixels 480
Flash mode Automatic
Host interface timeout period 2.55 seconds
Note
The camera name in the ownerName field of the CmCameraInfo data structure is not reverted to the factory setting by this call. u
RESULT CODES
Upon successful completion, CmRestoreDefaults returns noErr.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmGetStdFeatures on page 2-35, CmGetProductInfo on page 2-37, CmSetOwnerName on page 2-40, CmSetFlashMode on page 2-42, CmSetPictureMode on page 2-41
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
ownerName
Address of a character string (32 bytes) to be stored in the camera. This string is used as the owner name identification for the camera. The name has a maximum length of 26 characters.
DESCRIPTION
The CmSetOwnerName function changes the owner name identification of the currently connected camera. The ownerName parameter points to an array of characters 32 bytes in length.
IMPORTANT
The owner name identification must be exactly 32 bytes—no more, no less. To accomodate mounting the QuickTake 100 on the Macintosh descktop, the owner name limit is set at 26 characters. When setting the camera owner name to 26 characters or less, be sure to use space characters to pad the ownerName parameter to 32 bytes.s
The current value for the owner name of the camera is contained in the ownerName field of the CmCameraInfo data structure, which is described on page 2-14. The CmCameraInfo data structure can be retrieved via a call to CmGetCameraInfo.
The camera owner name remains valid until the application issues another call to CmSetOwnerName.
RESULT CODES
The CmSetOwnerName function returns noErr if the identification has successfully been stored.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmGetCameraInfo on page 2-28, CmSetPictureMode, described next; CmSetFlashMode on page 2-42, CmGetErrorInfo on page 2-48
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
pictureMode
The picture mode for the camera.
DESCRIPTION
The CmSetPictureMode function changes the attributes related to the picture mode of the camera currently connected. The picture mode of the camera determines the type of pictures that will be taken by the camera.
The possible values for the pictureMode parameter are as follows:
kCmCOLOR The subsequent pictures taken shall be stored in full color.
kCmCOLORQ The subsequent pictures taken shall be in full color, but the size will be reduced to one-quarter (320 by 240 pixels) of the default full size (640 by 480 pixels).
The picture mode attributes are in effect until either the application makes another
call to the CmSetPictureMode function to set new values, the application makes a call to CmRestoreDefaults, or the user presses the corresponding resolution button on the camera.
Note
The resolution attributes of images already stored inside the camera prior to a call to CmSetPictureMode are not affected by the function.u
RESULT CODES
If the specified mode has successfully been registered in the camera, the CmSetPictureMode function returns noErr.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmRestoreDefaults on page 2-38, CmSetOwnerName on page 2-40, CmGetErrorInfo on page 2-48, CmSetFlashMode, described next
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
flashMode The flash mode to be registered in the camera.
DESCRIPTION
The CmSetFlashMode function registers a new flash mode in the camera currently connected. The flash mode of a camera determines whether the flash is to be on, off, or automatic. The possible values for the flashMode parameter are
kCmFlashOn The currently connected camera always uses the flash to take subsequent pictures.
kCmFlashOff
The currently connected camera does not use the flash to take subsequent pictures.
kCmFlashAuto
The currently connected camera automatically determines how the flash is used to take subsequent pictures.
The flash mode setting is in effect until either the application makes another call to the CmSetFlashMode function, the application makes a call to CmRestoreDefaults, or the user presses the corresponding flash button on the camera.
RESULT CODES
If the specified flash mode has successfully been registered, the CmSetFlashMode function returns noErr.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmSetOwnerName on page 2-40, CmSetPictureMode on page 2-41, CmRestoreDefaults on page 2-38, CmGetErrorInfo on page 2-48
CmSetSleep
pascal OSErr CmSetSleep
(CameraData cameraData, short sleepDelay);
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
sleepDelay A numeric value that represents the period of time the camera shall remain ready for command processing before entering the sleep state.
DESCRIPTION
The CmSetSleep function sets the time that the camera will remain fully active prior to entering the sleep state. When a QuickTake 100 camera is in the sleep state, the load on the batteries is reduced to help conserve battery life. The default time delay before the camera enters the sleep state is five minutes. The time delay is reset to five minutes after you disconnect from the camera.
The sleepDelay parameter is expressed as a number in the range 0 through 5 with the delay values corresponding to those shown in Table 2-1.
Table 2-1 CmSetSleep sleepDelay parameter values
Value Constant name Description
0 kCmSleepNow Enter the sleep state immediately.
1 kCmSleep5M Enter the sleep state after 5 minutes has elapsed.
2 kCmSleep15M Enter the sleep state after 15 minutes has elapsed.
3 kCmSleep30M Enter the sleep state after 30 minutes has elapsed.
4 kCmSleep60M Enter the sleep state after 60 minutes has elapsed.
5 kCmSleepNever Do not enter the sleep state.
The sleep delay time restarts after any command is sent to the camera.
Note
Once the QuickTake 100 camera enters the sleep state, any subsequent commands sent to the camera will return kCmCommError because the serial port connection will have timed out. To reestablish communication with the QuickTake 100 camera, the camera must be manually switched on again. Then your application can call the CmDisconnect function followed by a call to CmConnect to make a connection with the camera.u
RESULT CODES
The CmSetSleep function returns noErr if successful.
If an error is detected, one of the following values is returned:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
decompTablePtr
Pointer to the location in which this function writes the decompression data corresponding to the camera. The decompression information is needed to expand images retrieved from the camera. The size of the memory allocated must be greater than or equal to the size of the structure, which is 98 bytes in length.
DESCRIPTION
The CmGetDecompTable function returns the compression table structure corresponding to the camera currently connected. Windows applications pass this structure to the IPM with the IpSetCompressionTable function. The IPM uses the information in this structure to decompress the image data from the camera before any display of the picture can take place on the host computer.
See the functions defined in Chapter 4, “Displaying QuickTake 100 Images in a Windows Application,” for more information about how the compression table data structure returned by this function is used by the IPM.
RESULT CODES
The CmGetDecompTable function returns noErr if the data is successfully retrieved and written to the area pointed to by decompTablePtr.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmGetColorCorrectionMatrix, described next; CmGetErrorInfo on page 2-48; and the functions described in Chapter 4, “Displaying QuickTake 100 Images in a Windows Application”
CmGetColorCorrectionMatrix
pascal OSErr CmGetColorCorrectionMatrix
(CameraData cameraData,
CmColorMatrixPtr colorMatrix);
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
colorMatrix
Pointer to the location in which this function writes the CmColorMatrix data corresponding to the camera. The size of the memory allocated must be greater than or equal to the size of the CmColorMatrix data structure.
DESCRIPTION
The CmGetColorCorrectionMatrix function returns the CmColorMatrix data structure corresponding to the camera currently connected. Windows applications must pass this data structure to the IPM to accurately reproduce the QuickTake 100 image on the host display. See the functions defined in Chapter 4, “Displaying QuickTake 100 Images in a Windows Application,” for more information about how the data structure returned by this function is used by the IPM.
Since the color matrix and image compression schemes in the camera may change in the future, it is always important to check the version number of the color matrix. You must make adjustments in your image processing setup, based on the version number of the color matrix in the camera as follows:
On the Windows platform, if the color matrix in the camera is version 1, use the default color matrix in the Windows IPM and pass that matrix back to the IPM for image processing. If it is not version 1, pass the color matrix returned by the camera to the IPM.
On the Macintosh platform, if the color matrix is not version 1, get the color matrix from the camera, and fill in the color matrix field for the PICT QuickTake file definition passsed to the QuickTake QuickTime decompressor with the camera color matrix. If the version number is 1, process and display the images with the QuickTake decompressor using the same method you use for QuickTime PICT files. See Chapter 5, “Displaying QuickTake 100 Images in a Macintosh Application” for more information about displaying QuickTake images on the Macintosh computer platform.
RESULT CODES
The CmGetColorCorrectionMatrix function returns noErr if the data is successfully retrieved and written to the area pointed to by colorMatrix.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmGetDecompTable on page 2-45; CmGetErrorInfo, described next; and the functions described in Chapter 4, “Displaying QuickTake 100 Images in a Windows Application”
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
category Address of a short into which this function returns the category code of a kCmCameraError error. The specifics of the category codes are provided in Table 2-2 on page 2-49.
detail Address of a short into which this function returns the detail code of a kCmCameraError error. The specifics of the detail codes are provided in Table 2-3 on page 2-50.
DESCRIPTION
The CmGetErrorInfo function retrieves detailed information about errors returned by the camera. The information returned by CmGetErrorInfo is a pair of short integers in the form category, detail.
When a camera error is detected by a call to one of the QuickTake 100 driver functions, the function returns kCmCameraError. To get detailed information about the camera error, call CmGetErrorInfo. For example, a call to the CmGetPictureInfo function with an invalid picture number parameter will cause the function to return a camera error kCmCameraError. To find out what condition caused the camera error, call CmGetErrorInfo, which will return the category and detail code pair kCmErBadPictureNumber and kCmErBadPictNumInfo.
The category code returned in the area pointed to by the category parameter provides information about the type of error encountered. The codes and definitions for category are listed in Table 2-2. Codes are hexadecimal values.
02 kCmErMemoryFull Image memory is full, cannot take another picture.
03 kCmErFlashNotReady Flash not ready for requested operation.
04 kCmErImageMemoryDefect An error has been detected in the camera image memory.
05 kCmErAttention A recoverable error or camera state change has been detected. See also the description of the kCmErCommandAborted detail error code in Table 2-3.
06 kCmErParityError An error has been detected in the RAM.
07 kCmErTimeoutError A communication error between the camera and host has occurred.
08 kCmErHardwareError An unrecoverable hardware error has occurred.
09 kCmErBadParameter An unrecoverable error caused by invalid values in a function call has occurred.
0A kCmErBadPictureNumber An invalid picture number parameter has occurred.
FF kCmErUnknownError Call Apple if you get this category code.
As described earlier, each error category has an associated detail code. The detail code returned in the area pointed to by the detail parameter provides specific information about the error that occurred. The codes, mnemonics, and definitions for detail are listed in Table 2-3. Codes are hexadecimal values.
18 kCmErCommandAborted An asynchronous operation has been successfully terminated by the host. If the application cancels an asynchronous operation and if the operation is successfully canceled, the callback routine for that operation returns a status code of CmCameraError. A call to CmGetErrorInfo will then return the category and detail code pair kCmErAttention and kCmErCommandAborted .
19 kCmErTooManyImageMemoryDefects
An error has been detected in the image memory after all of the spare image memory blocks have been used.
Note
CmGetErrorInfo itself may return kCmCameraError.u
This function returns noErr when called without your application having detected a kCmCameraError error. In this case, the areas pointed to by category and detail will both contain kCmErNoError.
RESULT CODES
The CmGetErrorInfo function returns noErr if error information has successfully been retrieved from the camera currently connected. The areas pointed to by category and detail contain detailed information related to the last error detected.
If an error is detected, the value returned is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
DESCRIPTION
The CmCheckIfReady function determines whether the camera currently connected is ready for subsequent host command processing. This function provides a simple way to confirm that the currently connected camera is still connected to the host.
RESULT CODES
CmCheckIfReady returns noErr if the camera is ready to process commands from the host computer. Otherwise, it returns one of the values listed here:
kCmAIPError -6201 An asynchronous operation is already in progress. Windows platform only.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with a QuickTake 100 camera. Windows platform only.
SEE ALSO
CmSelfTest, described next; CmGetErrorInfo on page 2-48
CmSelfTest
pascal OSErr CmSelfTest(CameraData cameraData);
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
DESCRIPTION
The application calls the CmSelfTest function to trigger the diagnostics test built into the camera currently connected.
RESULT CODES
The CmSelfTest function returns noErr if the test has successfully been completed.
If the test is not successful, the function returns one of the values listed here:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with a QuickTake 100 camera. Windows platform only.
SEE ALSO
CmCheckIfReady on page 2-52, CmGetErrorInfo on page 2-48
Retrieving and Capturing Images
The functions in this group are used to retrieve and capture images.
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
pictureNo The number identifying the picture whose thumbnail image is to be retrieved.
thumbnailBuffer
Address of the area to be filled with the data that represent the thumbnail image.
numberOfBytesToRead
Number of bytes of data to be read into thumbnailBuffer. This value must be a multiple of 512 unless the entire thumbnail is being transferred in a single call or the last block of data in a multiple-call sequence is read.
firstRead If TRUE, uploads the image from the beginning.
actualBytes
Address of an area to which this function returns the number of bytes actually read into thumbnailBuffer.
DESCRIPTION
The CmGetThumbnailImage function retrieves the thumbnail version of the image of a particular picture. To make presenting previews of an image in an application easier, the QuickTake 100 camera is capable of sending the host computer a miniaturized version of the image corresponding to a specified picture. This version of the image is called the thumbnail image.
The total number of bytes in a thumbnail image is 2400. The numberOfBytesToRead parameter may be less than that. In this case, multiple calls to this function are necessary to get the entire thumbnail image.
When making multiple calls to retrieve an image, the application sets firstRead to TRUE the first time the function is called on a particular image, and then sets it to FALSE for the subsequent calls to this function to get the remaining blocks of the image. The area pointed to by the last parameter, actualBytes, contains the number of bytes actually transferred into the buffer pointed to by thumbnailBuffer.
Note
Note
It is the responsibility of the application to allocate the buffer pointed to by thumbnailBuffer. u
If you plan to have your application upload the image in chunks of blocks, then
you should not attempt to call any QuickTake 100 driver function (including CmGetThumbnailImage invoked on a different pictureNo parameter) in between successive calls to CmGetThumbnailImage. If you do make other calls on a different picture, it causes the current upload operation to terminate prematurely, and the application will have to restart the upload from the beginning (firstRead = TRUE).
The application is expected to know exactly how many times to call this function with the appropriate size buffer (see CmGetPictureInfo). Trying to read image data beyond the actual size of the image will result in an error.
The CmGetThumbnailImage function does not return until it has retrieved the specified number of bytes or it has finished. If you want your application to pursue a different thread of execution while retrieving thumbnail data, you should call CmGetThumbnailImageAsync instead of CmGetThumbnailImage.
For information about decoding the data format of the image returned by this function, see the CmGetDecompTable function described on page 2-45 and the CmGetColorCorrectionMatrix function described on page 2-46.
RESULT CODES
Upon successful completion, the CmGetThumbnailImage function returns noErr, and the area pointed to by thumbnailBuffer is filled with the thumbnail image corresponding to the picture identified by the parameter pictureNo.
If an error is detected, this function returns one of the values listed here. Note that when an error occurs, the content of the area pointed to by thumbnailBuffer is undefined.
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmGetPictureInfo on page 2-29; CmGetFullSizeImage on page 2-57; CmGetThumbnailImageAsync, described next; CmGetErrorInfo on page 2-48
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
pictureNo The number identifying the picture whose thumbnail image is to be uploaded.
thumbnailBuffer
Address of a data area to be filled with the data that represent the thumbnail image.
numberOfBytesToRead
Number of bytes of data to be read into thumbnailBuffer. This value must be a multiple of 512 unless the entire thumbnail is being transferred in a single call or the last block of data in a multiple-call sequence is read.
firstRead If TRUE, upload starts from the beginning of the image specified.
asyncCompletionRoutine
Address of a callback function to be called by the driver when the data transfer is complete.
DESCRIPTION
The CmGetThumbnailImageAsync function is the asynchronous version of CmGetThumbnailImage and is provided for Windows applications that pursue other activities during the time in which a thumbnail image is being retrieved from the camera. The parameters are the same as those supplied to the CmGetThumbnailImage function, except for the last parameter, which is an address of a callback function to be called when the total number of bytes of data specified in numberOfBytesToRead has been transferred to the location pointed to by thumbnailBuffer. (See CmAsyncCompletionRoutine on page 2-33 for information about the callback function.)
The address of the callback routine handed to this function must be the one returned by the Windows function MakeProcInstance.
IMPORTANT
IMPORTANT
Your application should not issue a call to any QuickTake 100 driver function (including this function) before completion routine has been called. Likewise, the application should not call any QuickTake 100 driver function other than this function during the time an image is being retrieved.
The CmGetThumbnailImageAsync function is valid only for the Windows platform. s
RESULT CODES
Upon successful completion, the CmGetThumbnailImageAsync function returns noErr.
If an error is detected, this function returns one of the values listed here:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmNoMemoryError -6209 System failed to allocate memory.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
SEE ALSO
CmAsyncCompletionRoutine on page 2-33, CmCancelAsyncOperation on page 2-34, CmGetThumbnailImage on page 2-54, CmGetFullSizeImageAsync on page 2-60, CmGetDecompTable on page 2-45, CmGetColorCorrectionMatrix on page 2-46, CmGetErrorInfo on page 2-48
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
pictureNo The number identifying the picture whose full-size image is to be uploaded.
imageBuffer
Address of the buffer into which data corresponding to the image is to be stored.
numberOfBytesToRead
The number of bytes of data to be transferred to imageBuffer. This value must be a multiple of 512 unless the entire image is being transferred in a single call or when the last block of data in a multiple-call sequence is read.
firstRead If TRUE, data is transferred beginning from the start of the image.
actualBytes
Address of a memory location into which this function writes the number of bytes actually transferred into imageBuffer.
Note
Windows applications should not use the BufferPtr type for the imageBuffer parameter as it is defined on page 2-9 when making a call to the CmGetFullSizeImage function, if the number of bytes to read into the buffer required for the image is greater than 64,000 (high-resolution images require 115,200 bytes). Instead, use type coercion to change the type of the imageBuffer parameter to unsigned char huge*.u
DESCRIPTION
The CmGetFullSizeImage function retrieves the full-size image of the picture in the camera.
Your application may allocate enough memory to hold the entire amount of data comprising the image to be retrieved. In this case, set numberOfBytesToRead to the actual number of bytes of the image (see CmGetPictureInfo). The entire data retrieval process finishes with a single call to the function.
However, if host memory is in short supply, numberOfBytesToRead may be set to less than the actual number of bytes comprising the image. In this case, multiple calls to this function are necessary to upload all of the image data.
To make multiple calls to CmGetFullSizeImage, set firstRead to TRUE in the first call to the function on a particular image, and then set firstRead to FALSE for the subsequent calls to get the remaining blocks of the image. The area pointed to by the last parameter, actualBytes, contains the number of bytes actually transferred into the buffer pointed to by imageBuffer.
For information about decoding the data format of the image returned by this
function, see the CmGetDecompTable function described on page 2-45, the CmGetColorCorrectionMatrix function described on page 2-46, the IpGetCompressionTable function described on page 4-18, the IpSetCompressionTable function described on page 4-19, and the IpInitCompressionTable function described on page 4-9.
It is the responsibility of your application to allocate the buffer pointed to by imageBuffer.
Note
If your application uploads the image in chunks of blocks, it should not attempt to call any QuickTake 100 driver function (including this function on a different picture) in between successive calls to CmGetFullSizeImage. Any attempt at calling another function causes the current retrieval operation to end prematurely and makes it necessary to restart the process from the beginning (firstRead = TRUE).
The application is expected to know exactly how many times it must call CmGetFullSizeImage and with how large a buffer. Attempting to read image data beyond the actual size of the data results in an error.
The CmGetFullSizeImage function does not return to the application until it has retrieved the specified number of bytes or it has finished. u
If you want your application to pursue a different thread of execution during the retrieval process, call CmGetFullSizeImageAsync instead of CmGetFullSizeImage.
RESULT CODES
Upon successful completion, the CmGetFullSizeImage function returns noErr and the area pointed to by imageBuffer is filled with the image corresponding to the picture identified by the second parameter, pictureNo.
If an error is detected, CmGetFullSizeImage returns one of the values listed here. Note that when an error occurs, the content of the area pointed to by the imageBuffer parameter is undefined.
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmGetCameraInfo on page 2-28; CmGetPictureInfo on page 2-29; CmGetThumbnailImage on page 2-54; CmGetFullSizeImageAsync described next; CmGetDecompTable on page 2-45; CmGetColorCorrectionMatrix on page 2-46; CmGetErrorInfo on page 2-48
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
pictureNo The number identifying the picture whose full-size image is to be uploaded.
imageBuffer
Address of the buffer into which data corresponding to the image is to be stored.
numberOfBytesToRead
The number of bytes of data to be transferred to imageBuffer. This value must be a multiple of 512 unless the entire image is being transferred in a single call or when the last block of data in a multiple-call sequence is read.
firstRead If TRUE, data is transferred beginning from the start of the image.
asyncCompletionRoutine
Address of a callback function to be called when the specified number of bytes has been transferred to the buffer pointed to by imageBuffer.
DESCRIPTION
The CmGetFullSizeImageAsync function is the asynchronous version of CmGetFullSizeImage and is provided for Windows applications that pursue a different thread of execution during the time the image retrieval process is taking place.
The parameters are the same as those supplied to the CmGetFullSizeImage function except for the last parameter, asyncCompletionRoutine, which is the address of a callback routine to be called after the specified number of bytes have been transferred to the memory location pointed to by imageBuffer. (See CmAsyncCompletionRoutine on page 2-33.)
For Windows applications, the address of the callback routine handed to this function must be the one returned by the Windows function MakeProcInstance.
IMPORTANT
Your application should not attempt to call any of the QuickTake 100 driver functions (including this function) prior to the time that the QuickTake 100 driver calls your callback routine.
Likewise, you should not attempt to issue calls to any of the QuickTake 100 driver functions (except this function) while the image retrieval process is taking place. s
The CmGetFullSizeImageAsync function is valid only for the Windows platform.
RESULT CODES
Upon successful completion, the CmGetFullSizeImageAsync function returns noErr.
If an error is detected, the value returned by this function is one of the following:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmNoMemoryError -6209 System failed to allocate memory.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
SEE ALSO
CmAsyncCompletionRoutine on page 2-33, CmCancelAsyncOperation on page 2-34, CmGetFullSizeImage on page 2-57, CmGetThumbnailImageAsync on page 2-56, CmGetErrorInfo on page 2-48
CmTakePicture
pascal OSErr CmTakePicture(CameraData cameraData,
Boolean timerOn);
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
timerOn If TRUE, the camera will take a picture at the expiration of its internal timer. If FALSE, the picture is taken immediately.
DESCRIPTION
The CmTakePicture function causes the camera currently connected to take a picture.
Setting timerOn to FALSE causes the next picture to be taken immediately. Setting it to TRUE causes the camera to take the picture at the expiration of its internal timer.
IMPORTANT
The number of pictures that can be taken by the camera must at least be 1 in order for the CmTakePicture function to succeed.
CmTakePicture does not return to the application until the camera has finished attempting to take a picture. Care should be taken to ensure that the function has completed the picture-taking operation when timerOn is specified as TRUE. s
RESULT CODES
If a picture has successfully been taken, the CmTakePicture function returns noErr.
If an error is detected, this function returns one of the following values:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera. Macintosh platform only.
kCmCommError -6214 A serial communication error occurred. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
kCmProtocolError -6212 Protocol error during communication with QuickTake 100 camera. Windows platform only.
SEE ALSO
CmGetCameraInfo on page 2-28; CmTakePictureAsync, described next; CmErase on page 2-31; CmGetErrorInfo on page 2-48
cameraData The private data structure returned by CmOpenDriver when your application opens the QuickTake 100 device driver.
timerOn If TRUE, the camera will take a picture at the expiration of its internal timer. If FALSE, the picture is taken immediately.
asyncCompletionRoutine
Address of a callback routine to be called after a picture has been taken.
DESCRIPTION
The CmTakePictureAsync function is the asynchronous version of CmTakePicture and is provided for applications that pursue a different thread of execution during the time a picture is being taken by the camera currently connected.
For Windows applications, the address of the callback routine handed to this function must be the one returned by the Windows function MakeProcInstance.
IMPORTANT
Your application should not attempt to call any of the QuickTake 100 driver functions including this function before the corresponding callback routine has been invoked.
Care should be taken to ensure that the function has completed its picture taking operation when timerOn is specified as TRUE.
Windows applications cannot cancel this function by calling CmCancelAsyncOperation.s
RESULT CODES
The CmTakePictureAsync function returns noErr if the request is successful.
If an error is detected, this function returns one of the following error values:
kCmAIPError -6201 An asynchronous operation is already in progress.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCantCancel Currently outstanding asynchronous operation cannot be canceled. Windows platform only.
kCmNoMemoryError -6209 System failed to allocate memory. Windows platform only.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNotOpenError -6211 The QuickTake 100 driver has not been initialized.
SEE ALSO
CmAsyncCompletionRoutine on page 2-33, CmCancelAsyncOperation on page 2-34, CmTakePicture on page 2-61, CmEraseAsync on page 2-32, CmGetErrorInfo on page 2-48
C-Language Summary of the QuickTake 100 Device Driver
Constants
/* CmSetPictureMode picture modes */
kCmColor 0x10
kCmColorQ 0x20
/* CmSetFlashMode flash modes */
kCmFlashOn 0x02
kCmFlashOff 0x01
kCmFlashAuto 0x00
/* CmSetOwnerName owner name string length */
kCmMAXIDWIDTH 32
/* decompression table size */
kCmDecompTableSize 98
/* sleep modes */
kCmSleepNow 0
kCmSleep5M 1
kCmSleep15M 2
kCmSleep30M 3
kCmSleep60M 4
kCmSleepNever 5
/* battery status indicators */
kPowerAdapter 140 /* Power adapter is connected */
kBatteryRangeFull 95 /* Battery is fully charged */
kBatteryIconFull 86 /* Values >= 86 indicates the battery
icon shows full charge */
kBatteryIconHalf 80 /* Values 80 through 85 indicate that the battery
icon shows half charge */
kBatteryRangeEmpty 75 /* Battery has an insufficient charge, battery
icon shows empty*/
Data Types
CameraData
For the Macintosh platform CameraData is defined as
typedef CmCameraData* CameraData;
For the Windows platform CameraData is defined as
typedef unsigned short CameraData;
BufferPtr
For the Macintosh platform BufferPtr is defined as
kCmAIPError -6201 An asynchronous operation is already in progress. Windows platform only.
kCmAlreadyOpenError -6202 The CM is already open.
kCmANIPError -6203 No asynchronous operation is outstanding.
kCmBadArgError -6204 Parameter is or contains an address of an invalid data item.
kCmCameraError -6200 Error detected by the camera. Call CmGetErrorInfo.
kCmCameraNotFoundError -6206 Device connected to the port is not a QuickTake 100 camera.
kCmCantCancel Currently outstanding asynchronous operation cannot be canceled.
kCmCurrentlyConnectedError -6205 The camera is already connected.
kCmCommError -6214 A serial communication error occurred.
kCmDriverNotLoadedError -6213 The camera device driver was not initialized.
kCmNoMemoryError -6209 System failed to allocate memory.
kCmNotConnectedError -6208 A connection with the camera has not been made.
kCmNoSuchPortError -6210 Corresponding port does not exist.
kCmNotOpenError -6211 The CM has not been initialized.
kCmProtocolError -6212 Protocol error during communication with a QuickTake 100 camera.
kCmSystemError Windows DLL failed to either register its class or to create a window.
kNoPortErr -7947 Corresponding port does not exist.
kNoPodErr -7937 Device connected to the port is not a QuickTake 100 camera.
kSoftwareInstallErr -7945 Either or both the GeoPort or Shared Library Manager extensions are not installed. Macintosh platform only.
memFullErr -108 Not enough memory to process the requested operation. Macintosh platform only.
paramErr -50 Parameter is or contains an address of an invalid data item. Macintosh platform only.
QuickTake 100 Images
The information in this chapter applies to QuickTake 100 images on the Macintosh and Windows platforms.
This chapter provides a brief description of the QuickTake 100 file format, information about the memory requirements for the display formats supported by the Macintosh and Windows image processing software, and information about the color depth of each display format. For information about how to display QuickTake 100 images in Windows applications, see Chapter 4, “Displaying QuickTake 100 Images in a Windows Application.” For information about how to display QuickTake 100 images in Macintosh applications, see Chapter 5, “Displaying QuickTake 100 Images in a Macintosh Application.”
QuickTake 100 images are stored in the camera in a compressed format. You retrieve the compressed image data from the camera by making function calls to the QuickTake 100 device driver. The QuickTake 100 device driver loads the raw compressed image data from the camera into host memory. On the Windows platform, the image processing software provides function calls to decompress the raw image data in memory into a format that can be displayed on the host computer. On the Macintosh platform, a QuickTime decompressor provides the necessary image processing services.
On the Macintosh platform, the QuickTake 100 files saved by the QuickTake 100 application contain a 512 byte header of application-specific data followed by an in-memory Macintosh PICT file and a QuickTake 100 thumbnail definition. QuickTake 100 files can be displayed on the Macintosh by taking all of the data in the file after the first 512 bytes and displaying that data with QuickDraw in the same way that a PICT file with a QuickTime compressed opcode is displayed.
A sample code listing that shows how to use the QuickTake 100 device driver functions to retrieve raw image data from the QuickTake 100 camera is provided on page 2-5 in Chapter 2, “QuickTake 100 Driver Software.”
QuickTake 100 Image Sizes
QuickTake 100 images are stored in three image resolutions: high-resolution, standard-resolution, and thumbnail. The amount of memory, in bytes, for three image resolutions in the output formats supported by the QuickTake 100 image processing software is shown in Table 3-1.
Table 3-1 Memory sizes of supported QuickTake 100 image formats in bytes
Image format High-resolution Standard-resolution Thumbnail
(640 x 480 pixels) (320 x 240 pixels) (80 x 60 pixels)
ADPCM compressed 115,200 28,800 n/a
Color difference 307,200 76,800 4800
Thumbnail compressed n/a n/a 2400
8-bit grayscale 307,200 76,800 n/a
24-bit DIB 921,600 230,400 n/a
32-bit RGB 1,228,800 307,200 n/a
DIB (device-independent bitmap) is the native image format for Microsoft Windows. This array of RGB triples contains only the image data. It is the responsibility of the Windows application programmer to imbed the data in the proper bitmap format.
Image Color Depth
The QuickTake 100 image processing software converts QuickTake 100 images into display-ready pictures with the color depth and display formats shown in Table 3-2.
Table 3-2 Picture display formats and color resolutions
Display format Bits per pixel Colors Operating-system support
Grayscale 8 256 Macintosh, MS Windows
DIB 24 16.7 million Windows
RGB 32* 16.7 million Macintosh
* The 32-bits-per-pixel RGB format provides only 24 bits of color using the form NULL, Red, Green, Blue.
Displaying QuickTake 100 Images in a Windows Application
This chapter provides an overview of the technology used to process QuickTake 100 images for display with the Image Processing Module (IPM) in the Windows application environment. It also describes the data types and functions that are provided in the Windows IPM dynamic link library for the QuickTake 100 camera.
This chapter does not attempt to teach Windows programming. You should be familiar with the software tools required to use the IPM DLL in the Windows programming environment.
For information about how to display QuickTake 100 images in the Macintosh application environment, see Chapter 5, “Displaying QuickTake 100 Images in a Macintosh Application.”
Using the Windows IPM
Images are stored in the QuickTake 100 camera in a compressed format that cannot be readily displayed by the operating system. Therefore, it is necessary to decompress and convert the QuickTake 100 images into a data format that the operating system can display. The IPM DLL provides the functions that Windows applications call to decompress and convert QuickTake 100 images retrieved from the camera into a format that the operating system can display on the host computer.
The IPM DLL for Windows is a collection of functions that convert QuickTake 100 camera images to display-ready RGB picture formats. The QuickTake 100 image processing software supports display of grayscale, RGB, and DIB output formats. The IPM supports differential pulse-code modulation (DPCM) decompression, edge enhancement, and color correction. The default color correction settings of a QuickTake 100 image can be overridden with the IPM software to accommodate different video display characteristics. In addition, IPM functions are provided for image rotation and for adjusting color output using camera-specific color characteristics.
There are two fundamental methods that can be used for the QuickTake 100 image decompression and conversion process with the IPM: banded and unbanded. The banded method handles a user-specified strip of the image, while the unbanded method handles the complete image in memory. You may wish to try different band sizes to optimize the image conversion process for various system configurations.
An image band is a full-width portion of an image that can begin with any line and extend to the height of the image. Banded image processing is provided for situations in which there is not enough memory on the host to process a full image or when only a full-width portion of the image is needed. An example of the latter case might be for redisplaying a portion of an image that was previously covered by another window. You can also use banded processing to display bands of a picture as they are processed to indicate progress to the user.
Note
Note
When rotating an image using either the banded or unbanded image processing method, the full-color difference image must be resident in memory. Banded processing does not apply to thumbnail images.u
Banded image processing is performed with the IpConvertADPCMtoRGB function. The portion of the image to process is specified with the aStartingLine and aLinesPerBand fields in the ImageAttribute data structure. The value of aStartingLine must be 0 or an even number, and aLinesPerBand must be an even number that is greater than or equal to 2. To process the full image with a single call (unbanded processing), set aStartingLine to 0 and aLinesPerBand to the total image height in pixels.
The ImageAttribute data structure is shown here and further defined in “Data Types for the Windows IPM Functions” beginning on page 4-4.
typedef struct imageAttribute { /* input */
unsigned short aImgWidth;
unsigned short aImgLength;
/* output image attributes */
IpPixelType aPixelType;
RotateAngle aAngle;
unsigned short aStartingLine;
unsigned short aLinesPerBand;
Boolean firstBand;
Boolean lastBand;
} ImageAttribute;
The firstBand and lastBand fields in the ImageAttribute data structure can be used to optimize performance and to manage memory more efficiently. When firstBand is TRUE, the IPM allocates a color difference image (CDI) buffer as needed or reuses the buffer from a previously processed image. In either case, it decompresses the image to get the CDI. When firstBand is FALSE, it indexes into the existing CDI buffer, according to the value in the aStartingLine field, to process the requested band.
Note
In the Windows environment it is possible to have a CDI buffer for each application interested in using the IPM.u
Table 4-1 shows how to use the firstBand and lastBand fields in the ImageAttribute data structure to process two images using the CDI buffer allocated for the first image. The first image is processed in three bands, and the second image is processed in the same CDI buffer in one band.
Table 4-1 Memory and image band processing
Image Band firstBand lastBand Memory use and processing technique
1 1 TRUE FALSE Allocate the CDI working buffer, decompress the image, and generate the CDI. After processing, the CDI buffer is retained.
1 2 FALSE FALSE Previously allocated CDI buffer is used to process the second band. After processing, the CDI buffer is retained.
1 3 FALSE FALSE Previously allocated CDI buffer is used to process the third band. After processing, the CDI buffer is retained.
2 1 TRUE TRUE Previously allocated CDI buffer is used to process the requested band of the second image. After processing, the CDI buffer is deallocated (lastBand = True).
IPM Error Handling
All IPM functions return a value either indicating successful completion or detailing a failure status. The include file ipm.h defines the values and mnemonics for these conditions. Errors also appear in the “Result Codes” section for each function description.
Image Processing Module Reference
The following sections describe the data types and functions supported by the Image Processing Module.
Note
This information is provided to give Windows programmers an idea of how to use the QuickTake 100 image processing software that will be available sometime in 1994.u
Data Types for the Windows IPM Functions
This section describes all of the data types referenced by the IPM functions. These declarations can be found in the ipm.h file.
ImageAttribute
The ImageAttribute structure provides information about the size of the QuickTake 100 source image and defines the parameters to be used by the IPM for the image output.
typedef struct imageAttribute { /* input */
unsigned short aImgWidth;
unsigned short aImgLength;
/* output image attributes */
IpPixelType aPixelType;
RotateAngle aAngle;
/* image banding parameters */
unsigned short aStartingLine;
unsigned short aLinesPerBand;
Boolean firstBand;
Boolean lastBand;
} ImageAttribute;
Field descriptions
aImgWidth Horizontal size of image, in pixels.
aImgLength Vertical size of image, in pixels.
aPixelType Color or gray; bits per pixel.
kGray8 = 8-bit (256 levels of gray)
kDIB24 = 24-bit (16 million colors)
aAngle Rotation angle of output image. See the RotateAngle structure described on page 4-6.
aStartingLine Starting line number of the output band.
aLinesPerBand Number of full-width lines in band.
firstBand Set to TRUE for first band of an image.
lastBand Set to TRUE for free working buffers.
Be sure to set up the ImageAttribute structure to disable banded processing when decompressing thumbnail data. Both the aStartingLine and aLinesPerBand fields must be set to 0, or a call to IpConvertThumbnailToRGB will return a kCmBadArgError error. For more information about decompressing thumbnail image data, see the description of IpConvertThumbnailToRGB function on page 4-10.
When you display a rotated image, set the aStartingLine and aLinesPerBand fields so that they refer to the entire rotated image. For example, a 320 by 240 image rotated either 90 degrees or 270 degrees will have a height of 320 lines when fully rotated. The span of the image will range from 0 to 320 during banded processing. The aImgWidth and aImgLength fields refer to the nonrotated image values. For more information about image processing, see the discussion of image processing starting on page 4-2 and the description of the IpConvertADPCMToRGB function on page 4-11.
Characteristics
The Characteristics structure controls the CRT RGB display phosphor chromaticity values and CRT gamma.
typedef struct characteristics {
XYChroma redChroma;
XYChroma greenChroma;
XYChroma blueChroma;
double gamma;
} Characteristics;
Field descriptions
redChroma Red phosphor chromaticity.
greenChroma Green phosphor chromaticity.
blueChroma Blue phosphor chromaticity.
gamma CRT gamma, color temperature in Kelvins.
XYChroma
The XYChroma structure provides the CRT RGB display phosphor and white-point chromaticity x and y values.
typedef struct xyChroma {
double xChroma;
double yChroma;
} XYChroma;
Field descriptions
xChroma Value for x chromaticity.
yChroma Value for y chromaticity.
RotateAngle
The RotateAngle structure provides the values for rotating a QuickTake 100 image counterclockwise.
The IPM functions described in this section perform operations on the compressed image data that is retrieved from the QuickTake 100 camera. These functions convert compressed QuickTake 100 images into formats that can be displayed on computers capable of running Microsoft Windows. To use these functions, be sure to include the ipm.h file in the include section of your code.
Note
All parameter pointers are of type far unless otherwise noted. u
Note
On the Macintosh computer, QuickTake 100 images are converted into display-ready PICT format files by a QuickTake 100 QuickTime decompressor. Converted QuickTake 100 images are shown on the Macintosh display using the same techniques used to display PICT files with QuickTime or QuickDraw. u
IpInitIPM
OSErr FAR PASCAL IpInitIPM(unsigned char far * ipm);
ipm Address that will contain the IPM private data structures for the application. This area of memory must be allocated by the application before this function is called. Be sure this memory area has been cleared prior to calling IpInitIPM. The size of this memory area is defined by the constant kIPMContextSize.
DESCRIPTION
The IpInitIPM function initializes the IPM. This function must be called once before any other IPM routines are called. During the initialization process IPM fills in the image processing data structures with default settings for the camera matrix and display characteristics. However, the values are not actually set prior to a call to the IpCalculateColorTables function. Therefore, you must first call the IpInitIPM function and then call IpCalculateColorTables before any image processing can take place.
If you change the settings for the default camera color matrix and display characteristics during a session with the IPM, those changes are not actually put to use until an IpCalculateColorTables function is called.
RESULT CODES
Upon successful completion, this function returns noErr and the IPM initializes the necessary internal data structures for use by subsequent function calls from the application.
If an error is detected, this function returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpContextExistsError The memory referenced by the ipm parameter has already been allocated by a previous call to IpInitIPM.
kIpNoMemoryError System failed to allocate system memory.
SEE ALSO
IpEndIPM, described next; IpCalculateColorTables on page 4-9
IpEndIPM
OSErr FAR PASCAL IpEndIPM(unsigned char far * ipm);
ipm Address of the private storage for the IPM. See the definition of the IpInitIPM function on page 4-8 for more information about the ipm parameter.
DESCRIPTION
The IpEndIPM function closes the IPM and deallocates associated memory allocated with the IpInitIPM function. The IpEndIPM function should always be called before exiting the IPM. The application is responsible for disposing of any application memory associated with using the IPM.
RESULT CODES
This function returns the value noErr upon successful completion.
If an error is detected, this function returns one of these values:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError This function was called without a previous call to IpInitIPM.
SEE ALSO
IpInitIPM on page 4-8
IpCalculateColorTables
OSErr FAR PASCAL IpCalculateColorTables(unsigned char far * ipm);
ipm Pointer to the memory allocated for the IPM.
DESCRIPTION
The IpCalculateColorTables function calculates and initializes the color processing tables with the current camera color matrix and display characteristics. The camera color matrix and display characteristics are modified with the IpSetCameraColorMatrix and IpSetDisplayCharacteristics functions.
You must call the IpCalculateColorTables function after initializing the IPM with IpInitIPM before attempting to process QuickTake 100 images.
You can call IpSetDisplayCharacteristics and IpSetCameraColorMatrix followed by a single call to IpCalculateColorTables to calculate the new color tables. In addition, if you only need to calculate the color tables after changing the camera color matrix or calculate the display characteristics after changing the display characteristics, you can follow either IpSetDisplayCharacteristics or IpSetCameraColorMatrix with a call to IpCalculateColorTables. This is also true for the IpInitDisplayCharacteristics and IpInitCameraColorMatrix functions.
RESULT CODES
This function returns noErr upon successful completion.
If an error is detected, IpCalculateColorTables returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
IpInitIPM on page 4-8, IpSetDisplayCharacteristics on page 4-14, IpInitDisplayCharacteristics on page 4-15, IpSetCameraColorMatrix on page 4-17, IpInitCameraColorMatrix, on page 4-17
IpConvertThumbnailToRGB
OSErr FAR PASCAL IpConvertThumbnailToRGB(unsigned char far * ipm,
unsigned char far * pCompedTNail,
unsigned char far * pTNailRGB,
ImageAttribute far * imgAttr);
ipm Pointer to the memory allocated for the IPM.
pCompedTNail
Pointer to the compressed thumbnail image.
pTNailRGB Pointer to the output RGB image.
imgAttr Pointer to the ImageAttribute data structure that describes the image referenced in pCompedTNail. Banded image processing does not apply to thumbnail images. Be sure to set the aStartingLine and aLinesPerBand fields in the ImageAttribute structure to 0 when processing thumbnail images.
DESCRIPTION
The IpConvertThumbnailToRGB function decompresses a thumbnail image and prepares it for display as specified by the ImageAttribute data structure pointed to by the imgAttr parameter.
RESULT CODES
This function returns noErr upon successful completion.
If an error is detected, this function returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpColorTablesNotCalculated Color parameters were initialized or changed without calculating the derived color processing tables. You must call IpCalculateColorTables before image processing can take place.
kIpNoContextExistsError The ipm parameter does not point to valid data.
kIpNoMemoryError System failed to allocate memory.
SEE ALSO
IpInitIPM on page 4-8, IpCalculateColorTables on page 4-9
IpConvertADPCMtoRGB
OSErr FAR PASCAL IpConvertADPCMtoRGB(unsigned char far * ipm,
unsigned char huge * pCompedCDI,
unsigned char huge * pRGB,
ImageAttribute far * imgAttr,
ProgressCallBack far * callBackProc);
ipm Pointer to the memory allocated for the IPM.
pCompedCDI
Pointer to the QuickTake 100 compressed color difference image.
pRGB Pointer to the RGB image output.
imgAttr Pointer to the ImageAttribute structure that describes the input and output images referenced by pCompedCDI and pRGB, respectively. When rotating images 90 or 270 degrees without using banded processing, the aLinesPerBand field in the ImageAttribute structure must be set to the rotated image height (either 640 for high-resolution images or 320 for standard-resolution images). When doing banded processing at 90 or 270 degrees, be sure to continue the process through the full rotated image height.
callBackProc
Address of a callback procedure to receive progress status.
DESCRIPTION
The IpConvertADPCMtoRGB function decompresses an ADPCM QuickTake 100 image and converts it, as specified by the ImageAttribute structure, to a display-ready format. The image is color corrected for display (color IpPixelTypes only). The resulting image is stored at the address specified in the pRGB parameter.
RESULT CODES
This function returns noErr upon successful completion.
If an error is detected, this function returns one of the values listed here:
kIpAppCancel Operation has been canceled by the application.
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpColorTablesNotCalculated Color parameters were initialized or changed without calculating the derived color processing tables. You must call IpCalculateColorTables before image processing can take place.
kIpNoContextExistsError The ipm parameter does not point to valid data.
kIpNoMemoryError System failed to allocate memory.
message Indicates the reason for the call. Valid messages are IpProgressInit, IpProgressUpdate, and IpProgressEnd. The IpProgressInit and IpProgressEnd messages may be used to create and dismiss the application’s progress indicator display.
percentComplete
For messages of type IpProgressUpdate only, should be the percentage of completion for the currently executing IPM function. This value is an integer between 0 and 100.
refcon Reference constant specified by the application and returned to the given callback procedure.
DESCRIPTION
The IpProgressProc callback procedure prototype provides a way for applications to monitor the time it takes to convert a compressed QuickTake 100 image into a display-ready RGB format. When an application-supplied callback procedure is passed to the IpConvertADPCMtoRGB function, that callback procedure will be called periodically as the image is processed to provide a progress indicator to the application. The application may choose to filter the callback status to the desired level and return without providing any user feedback.
RESULT CODES
This function returns noErr as long as the asynchronous operation is successful. If an error is detected during the operation, this function returns one of the values listed here:
kIpBadArgError The application received an invalid parameter.
kIpCancel The application wants to cancel the process. The IPM will discontinue its process and return the value kIpAppCancel.
SEE ALSO
IpConvertADPCMtoRGB on page 4-11
IpGetDisplayCharacteristics
OSErr FAR PASCAL IpGetDisplayCharacteristics
(unsigned char far * ipm,
Characteristics far * characteristics);
ipm Pointer to the memory allocated for the IPM.
characteristics
Pointer to the Characteristics structure for the current display. For information about the values returned by this function, see the description of the Characteristics data structure on page 4-6.
DESCRIPTION
The IpGetDisplayCharacteristics function returns the current CRT display characteristics in the area pointed to by the characteristics parameter.
RESULT CODES
This function returns noErr upon successful completion.
If an error is detected, this function returns one of these values:
kIpBadArgError The application received an invalid parameter.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
IpSetDisplayCharacteristics, described next; IpInitDisplayCharacteristics on page 4-15
IpSetDisplayCharacteristics
OSErr FAR PASCAL IpSetDisplayCharacteristics
(unsigned char far * ipm,
Characteristics far * characteristics);
ipm Pointer to the memory allocated for the IPM.
characteristics
Pointer to the new display characteristics structure. All supported display characteristics must be set when calling this function. You should retrieve the characteristics first, then modify them as necessary before passing them to this function.
This function supports the CRT chromaticities and gamma characteristics. For information about the values you can set with this function, see the description of the Characteristics structure on page 4-6.
DESCRIPTION
This function sets the values for a new color correction matrix using the given CRT display characteristics. It is used to customize the color processing of a QuickTake 100 image for accurate color reproduction on different display hardware.
After calling IpSetDisplayCharacteristics, call the IpCalculateColorTables function to calculate and initialize the new display characteristics for subsequent image processing. The IpCalculateColorTables function is described on page 4-9.
RESULT CODES
The IpSetDisplayCharacteristics function returns noErr upon successful completion.
If an error is detected, this function returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
IpCalculateColorTables on page 4-9, IpGetDisplayCharacteristics on page 4-13, IpInitDisplayCharacteristics, described next
IpInitDisplayCharacteristics
OSErr FAR PASCAL IpInitDisplayCharacteristics
(unsigned char far * ipm);
ipm Pointer to the memory allocated for the IPM.
DESCRIPTION
This function replaces the current CRT display characteristics and derived color processing tables with the default values shown in Table 4-2 and Table 4-3.
After calling IpInitDisplayCharacteristics, make a call to the IpCalculateColorTables function to calculate and set the default display characteristics for subsequent image processing. The IpCalculateColorTables function is described on page 4-9.
The IpInitDisplayCharacteristics function returns noErr upon successful completion.
If an error is detected, this function returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
Characteristics data structure on page 4-6, IpCalculateColorTables on page 4-9, IpGetDisplayCharacteristics on page 4-13, IpSetDisplayCharacteristics on page 4-14
IpGetCameraColorMatrix
OSErr FAR PASCAL IpGetCameraColorMatrix(unsigned char far * ipm,
double far * cameraMatrix);
ipm Pointer to the memory allocated for the IPM.
cameraMatrix
Address at which the current camera color matrix is returned.
DESCRIPTION
The IpGetCameraColorMatrix function returns the current camera color matrix in the user-specified location. The memory allocated to receive this information must be large enough to contain a 3-by-4 color matrix of type double.
IMPORTANT
Since the color matrix and image compression schemes in the camera may change in the future, it is always important to check the version number of the color matrix. You must make adjustments in your image processing setup, based on the version number of the color matrix in the camera as follows:
If the color matrix in the camera is version 1, use the default color matrix in the Windows IPM and pass that matrix back to the IPM for image processing. If it is not version 1, pass the color matrix returned by the camera to the IPM for subsequent image processing. See the IpInitCameraColorMatrix function on page 4-17 for information about initializing the default color matrix in the IPM.
RESULT CODES
The IpGetCameraColorMatrix function returns noErr upon successful completion.
If an error is detected, it returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
IpSetCameraColorMatrix, described next; IpInitCameraColorMatrix on page 4-17
IpSetCameraColorMatrix
OSErr FAR PASCAL IpSetCameraColorMatrix(unsigned char far * ipm,
double far * cameraMatrix);
ipm Pointer to the memory allocated for the IPM.
cameraMatrix
Address of the new 3-by-4 camera color matrix.
DESCRIPTION
The IpSetCameraColorMatrix function replaces values in the current camera color matrix with the user-supplied color tables in the cameraMatrix parameter. It is used to customize the color correction process to accommodate different display hardware and maintain compatibility with possible future changes in the color matrix used in the camera during the image capturing process.
After calling IpSetCameraColorMatrix, call the IpCalculateColorTables function to calculate and initialize the new color matrix for subsequent image processing. The IpCalculateColorTables function is described on page 4-9.
RESULT CODES
This function returns noErr upon successful completion.
If an error is detected, IpSetCameraColorMatrix returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
IpCalculateColorTables on page 4-9, IpGetCameraColorMatrix on page 4-16, IpInitCameraColorMatrix, described next
IpInitCameraColorMatrix
OSErr FAR PASCAL IpInitCameraColorMatrix(unsigned char far * ipm);
ipm Pointer to the memory allocated for the IPM.
DESCRIPTION
The IpInitCameraColorMatrix function replaces the current camera color matrix with default IPM color matrix values.
After calling IpInitCameraColorMatrix, call the IpCalculateColorTables function to calculate and initialize the default color matrix for subsequent image processing. The IpCalculateColorTables function is described on page 4-9.
RESULT CODES
The IpInitCameraColorMatrix function returns noErr upon successful completion and restores the default camera color matrix.
If an error is detected, it returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
IpCalculateColorTables on page 4-9, IpGetCameraColorMatrix on page 4-16, IpSetCameraColorMatrix on page 4-17
IpGetCompressionTable
OSErr FAR PASCAL IpGetCompressionTable(unsigned char far * ipm,
unsigned char far * compTable);
ipm Pointer to the memory allocated for the IPM.
compTable Address in which to store the current compression table.
DESCRIPTION
The IpGetCompressionTable function returns the compression table currently in use by the IPM at the location specified with the compTable parameter. The compTable memory area must be large enough to contain the entire compression table, which is specified by the value of the constant kIpDecompTableSize (98 bytes).
This function is useful when you want to ensure that the compression table you specified in an IpSetCompressionTable function call has been properly passed to the IPM.
RESULT CODES
The IpGetCompressionTable function returns noErr upon successful completion.
If an error is detected, IpGetCompressionTable returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
IpSetCompressionTable, described next; IpInitCompressionTable on page 4-9
IpSetCompressionTable
OSErr FAR PASCAL IpSetCompressionTable(unsigned char far * ipm,
unsigned char far * compTable);
ipm Pointer to the memory allocated for the IPM.
compTable Address of the new compression table.
DESCRIPTION
The IpSetCompressionTable function replaces the current compression table with the table specified by the compTable parameter. The compression table is retrieved from the camera with the CmGetDecompTable camera driver function, and it must be passed to the IPM unaltered to maintain image decompression compatibility with the associated images.
Any time you start a new session with the QuickTake 100 camera, you should retrieve the compression table and set it so that the IPM can use the appropriate compression table when processing any images downloaded during that session.
The CmGetDecompTable function allows an application to retrieve the current version of the compression table in the QuickTake 100 camera. It is described on page 2-45 in Chapter 2, “QuickTake 100 Driver Software.”
RESULT CODES
The IpSetCompressionTable function returns noErr upon successful completion.
If an error is detected, IpSetCompressionTable returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
CmGetDecompTable on page 2-45, IpGetCompressionTable on page 4-18, IpInitCompressionTable, described next
IpInitCompressionTable
OSErr FAR PASCAL IpInitCompressionTable(unsigned char far * ipm);
ipm Pointer to the memory allocated for the IPM.
DESCRIPTION
The IpInitCompressionTable function replaces the current compression table with the default compression table values. A default compression table is stored within the IPM.
You can check to see if the default compression table matches the current camera compression table by calling the IpInitCompressionTable function followed by a IpGetCompressionTable call to get the default compression table and then compare the default compression table to the table returned by a CmGetDecompTable function.
RESULT CODES
This function returns noErr upon successful completion.
If an error is detected, IpInitCompressionTable returns one of the values listed here:
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpNoContextExistsError The ipm parameter does not point to valid data.
SEE ALSO
CmGetDecompTable on page 2-45, IpGetCompressionTable on page 4-18, IpSetCompressionTable on page 4-19
kIpAppCancel Operation canceled by the application.
kIpBadArgError Parameter is or contains an address of an invalid data item.
kIpCancel The application wants to cancel the process. The IPM will discontinue its process and return the value kIpAppCancel.
KIpColorTablesNotCalculated Color parameters were changed without calculating the derived color processing tables. Call IpCalculateColorTables before attempting to process another image.
kIpContextExistsError The IPM is already open. This error occurs when IpInitIPM is called twice without an intervening call to IpEndIPM.
kIpNoContextExistsError The ipm parameter does not point to valid data.
kIpNoMemoryError System failed to allocate memory.
Displaying QuickTake 100 Images in a Macintosh Application
This chapter describes the method used to display QuickTake 100 images with an application running in the Macintosh Operating System.
The information presented here is for programmers who already understand how to use QuickTime, QuickTime Compressors, and QuickDraw to decompress and display picture files on the Macintosh computer.
QuickTake 100 QuickTime Decompressor
As described in Chapter 3, images captured in the QuickTake 100 camera are stored in compressed format that must be decompressed and converted to a picture format that can be displayed by the host operating system. Images stored on the camera must be retrieved from the camera with the QuickTake 100 device driver functions, described in Chapter 2, before decompression and conversion operations can be performed.
QuickTake 100 image processing support for the Macintosh Operating System is incorporated in a QuickTake 100 QuickTime decompressor. The QuickTake 100 QuickTime decompressor takes care of the details that would otherwise be associated with using the IPM functions to process the QuickTake 100 image data. Instead of manipulating the QuickTake 100 image data directly with the IPM functions, your application passes the QuickTake 100 image data along with an image description record that describes the image data to the QuickTake 100 QuickTime decompressor. The image description record is filled in with a file type of 'qktk', the height and width fields are set for the height and width of the image in pixels, and the dataSize field is set to the size of the compressed data in bytes. The QuickTake 100 decompressor then processes the data to create a Macintosh display-ready picture file.
To show the pictures on the Macintosh display, you will need to understand how to use QuickTime, the Image Compression Manager, and QuickDraw in your application. You should also be familiar with the ImageAttribute data structure described on page 4-5. Refer to Chapter 3 of Inside Macintosh: QuickTime for information about the Image Compression Manager.
QuickTake 100 images are converted into display-ready PICT format files by the QuickTake 100 QuickTime decompressor and the Image Compression Manager without your application having to call any of the IPM functions described in Chapter 4, “Displaying QuickTake 100 Images in a Windows Application.” Converted QuickTake 100 images are shown on the Macintosh display using the same techniques used to display PICT files with QuickTime or QuickDraw.
QuickTake 100 Serial Interface
This appendix contains information about the QuickTake 100 serial interface and connector. The serial interface is used by host computers to both control the QuickTake 100 camera and retrieve data from the QuickTake 100 camera.
Serial Port
The serial port on QuickTake 100 is located on the left side of the camera, as shown in Figure A-1.
Figure A-1 QuickTake 100 serial port location
It is an 8-pin mini-DIN socket with the physical pattern shown in Figure A-2. This is the same type of serial connector used on most Macintosh computers.
Figure A-2 QuickTake 100 serial port physical pattern
Protocol, Transfer Rate, and Data Format
The QuickTake 100 serial port supports Macintosh GeoPort high-speed serial communication protocols up to 920 kilobits per second (Kbps) and standard RS-232C serial protocols up to 57,600 bits per second (bps).
The GeoPort software built into the QuickTake 100 camera and the GeoPort system extension on the Macintosh computer take care of setting up the appropriate communication protocol and transfer rate for a serial connection. At system startup time, the GeoPort software performs what is called a beaconing phase. During the GeoPort beaconing phase many device-specific chores are attended to; one of these includes determining the fastest possible data transfer rate that can be supported by both QuickTake 100 and the Macintosh computer to which it is connected.
For computers that support Microsoft Windows, the QuickTake 100 camera uses the RS-232C serial protocol with a default transfer rate of 9600 bps and a data format of 8 data bits, with 1 stop bit, and even parity. The QuickTake 100 software supports transfer rates of 9600, 19,200, 38,400, and 57,600 bps for the Windows platform.
QuickTake 100 Serial Port Pin Assignments
The QuickTake 100 serial port conforms to RS-422 differential driver and receiver specifications and has the pin assignments described in Table A-1.
Table A-1 Serial port pin assignments
Pin number Signal name Signal description
1 HSKo Handshake output. This is the clock out signal on the QuickTake 100 camera and is not used by the RS-232C standard serial protocol.
2 HSKi Handshake input. This is the reset in signal on the QuickTake 100 camera.
3 TxD– Transmit data.
4 GND Signal ground.
5 RxD– Receive data.
6 TxD+ Transmit data (not used by standard serial protocol).
7 GPi Not used.
8 RxD+ Receive data (not used by standard serial protocol).
Serial Cables
A serial cable for connecting the QuickTake 100 camera to Macintosh computers (a mini-DIN 8 to mini-DIN 8 twisted-pair cable configuration) and a serial cable for connecting computers that use a D-sub 9-pin connector are provided in the QuickTake 100 package (see Figure A-3 and Figure A-6). In addition, a D-sub 9-pin to D-sub 25-pin adapter is also provided (see Figure A-6). This section provides diagrams that show how the pins in those serial cables are connected to make the appropriate serial connection with a QuickTake 100 camera.
To connect a Macintosh computer to the QuickTake 100 camera, use an Apple serial cable, part number M0197, or a cable with the pin and signal assignment connections shown in Figure A-4.
Figure A-3 QuickTake 100-to-Macintosh serial cable
Figure A-4 QuickTake 100-to-Macintosh serial cable pin assignments
The QuickTake 100-to-Macintosh cable is essentially a twisted-pair cable with the physical configuration shown in Figure A-5.
Computers, other than the Macintosh computer, that are capable of running Microsoft Windows use either D-sub 9-pin or D-sub 25-pin connectors conforming to the RS-232C specification. Figure A-6 shows the serial cable for connecting the QuickTake 100 mini-DIN 8-pin to a D-sub 9-pin connector and the adapter to connect the D-sub 9-pin cable end to a D-sub 25-pin RS-232C connector.
Figure A-6 QuickTake 100 8-pin mini-DIN to RS-232C serial cable and adapter
Figure A-7 shows how the pins and signals should be connected in a serial cable that connects the QuickTake 100 8-pin mini-DIN serial connector to an RS-232C D-sub 9-pin connector. The D-sub 9-pin to D-sub 25-pin adapter cable is a straight-through pin-to-pin configuration.
Figure A-7 QuickTake 100 8-pin mini-DIN to D-sub 9-pin RS-232C serial cable pin assignments
The D-sub 9-pin end of the mini-DIN 8-pin to D-sub 9-pin cable has a female connector with the physical pinout shown in Figure A-8.
Figure A-8 D-sub 9-pin physical pinout on a QuickTake 100 to D-sub 9-pin serial cable
The D-sub 9-pin end of a D-sub 9-pin to D-sub 25-pin RS-232C adapter cable has a male connector with the physical pinout shown in Figure A-9.
Figure A-9 D-sub 9-pin physical pinout on a D-sub 9-pin to D-sub 25-pin adapter cable
The D-sub 25-pin end of a D-sub 9-pin to D-sub 25-pin RS-232C adapter cable has a female connector with the physical pinout shown in Figure A-10.
Figure A-10 D-sub 25-pin physical pinout on a D-sub 9-pin to D-sub 25-pin adapter cable
QuickTake 100 Camera Specifications
The specifications for the QuickTake 100 camera are listed in Table B-1.
Table B-1 Venus specifications
Feature Description
Absolute accuracy ±0.5 pixel; any possible distortion is caused by the optical lens in front of the CCD sensor.
Color temperature Flash operation 5500 kelvins
Daylight operation 6000 kelvins
Exposure Automatic exposure adjustment
Exposure time 1/175 to 1/30 seconds
Flash Capacitive discharge flash tube
7-second interval between flashes (new battery)
Flash range 4 to 15 feet
Focus Fixed; 4 feet to infinity
Image capture Color CCD (charged couple device)
Image counter Additive, 0 to 32 depending on image-resolution setting
Lens 5-element antireflective coated lens with a range of 4 feet to infinite with fixed focus equivalent focal length to 40 mm in a
35-mm camera.
Lens cover Horizontal sliding cover, actuates camera power on switch.
Power source Three 1.5 V AA batteries
AC line adapter 4 to 8 volts at 1.5 amps
120 V ± 10% 48Hz–62Hz (U.S.)
100, 120, 200, 220, 240 V ± 10% 48Hz–62Hz (international)
Self-timer Built-in electronic type with LED indicator
Serial interface RS-422 GeoPort high-speed serial
RS-232C standard serial protocol
Serial transfer rate 9600 to 920 Kbps (Macintosh driver)
9600 to 57,600 bps (Windows driver)
Shutter Programmable stepping motor drive, 2.8 to 16F,
± 0.5 EV accuracy
Index
A
application-defined routines2-33
asynchronous camera operations, erasing images2-32
asynchronous image retrieval2-60
asynchronous retrieval of thumbnail images2-56
asynchronous routines, canceling2-34
B
banded image processing4-2
color difference image buffer4-4
BufferPtr data type2-9
C
calculating the color tables4-9
camera
capturing images2-63
color correction matrix2-47, 4-16
compression table2-45
data types2-8 to 2-19
default characteristics2-38
default flash mode2-38
default timeout2-38
determining features2-36
determining if connected2-52
disconnecting2-28
driver software for Macintosh platform1-3
driver software for Windows platform1-4
error category codes2-48
error detail codes2-50 to 2-51
establishing a connection2-3, 2-25
factory settings2-38
features1-4
getting compression table2-45
getting image information2-30
getting information2-28
image resolution1-2
image types1-2
owner name2-40
picture types1-2
product information2-37
setting date and time2-39
setting flash mode2-43
setting owner name2-40
setting picture mode2-41
setting sleep mode2-44
camera color matrix4-16
camera connection functions2-22 to 2-28
camera control functions2-28 to 2-53
camera controls1-4 to 1-6
erase all1-6
flash1-5
power on and off1-5
resolution1-6
shutter1-6
timer1-6
CameraData data type2-9
camera data structures2-8 to 2-19
camera device driver2-2
asynchronous operations2-8
closing2-21
constants2-64
data types2-8 to 2-19, 2-65 to 2-67
defined2-2
getting camera compression table2-45
initializing2-3, 2-20
opening2-3, 2-20
using2-2
camera device driver functions2-19 to 2-63
errors2-2
result code2-2
camera errors2-48
camera image retrieval functions2-54 to 2-61
camera images2-30
camera information2-37
camera initialization functions2-20 to 2-22
camera matrix4-8
canceling asynchronous routines2-34
capturing images1-2, 2-4
capturing images asynchronously2-63
Characteristics data type4-6, 4-22
closing the camera connection2-4
closing the camera device driver2-5, 2-21
closing the Image Processing Module4-9
CmAsyncCompletionRoutine function2-33 to 2-34
CmCameraInfo data type2-14 to 2-17, 2-67
CmCancelAsyncOperation function2-34 to 2-35
CmCheckIfReady function2-52
CmCloseDriver function2-5, 2-21
CmColorMatrix data type2-19, 2-67
CmConnect function2-3, 2-25 to 2-27
CmDateAndTime data type2-12, 2-66
CmDisconnect function2-4, 2-27 to 2-28
CmDisposePortInfo function2-24 to 2-25
CmErase function2-31
CmGetCameraInfo function2-4, 2-28 to 2-29
CmGetColorCorrectionMatrix function2-46 to 2-48
CmGetDecompTable function2-45 to 2-46
CmGetErrorInfo function2-48 to 2-52
CmGetFullSizeImageAsync function2-60 to 2-61
CmGetFullSizeImage function2-4, 2-57 to 2-60
CmGetPictureInfo function2-4, 2-29 to 2-30
CmGetPortInfo function2-3, 2-22 to 2-24
CmGetProductInfo function2-37
CmGetStdFeatures function2-35 to 2-36
CmGetThumbnailImageAsync function2-56 to 2-57
CmGetThumbnailImage function2-4, 2-54 to 2-56
CmOpenDriver function2-3, 2-20
CmPicture data type2-67
CmPictureInfo data type2-18 to 2-19
CmPortInfo data type2-10, 2-65
CmPortInfo structure2-3
CmProductInfo data type2-12, 2-66
CmRestoreDefaults function2-38 to 2-39
CmSelfTest function2-53
CmSetDateAndTime function2-39 to 2-40
CmSetFlashMode function2-42 to 2-43
CmSetOwnerName function2-40 to 2-41
CmSetPictureMode function2-41 to 2-42
CmSetSleep function2-44 to 2-45
CmStdFeatures data type2-10, 2-65
CmTakePictureAsync function2-62 to 2-63
CmTakePicture function2-4, 2-61 to 2-62
color correction matrix2-47
color correction tables4-17
color difference image buffer4-3
color processing tables4-15
completion routine2-8
application globals2-34
compression table2-45
determining4-18
converting thumbnail images to RGB format4-10
CRT chromaticity characteristics4-14
D
data transfer speed, determining2-26
default compression table4-20
determining the color correction matrix2-47
device driver version number2-36
device-independent bitmap3-3
display characteristics4-8
default values4-15
determining4-13
setting4-14
display formats3-3
DLLs (dynamic link libraries)2-2
DLL version number2-36
E
erasing images2-31
erasing images asynchronously2-32
erasing pictures1-6
establishing a camera software connection2-3
F
file format, QuickTake 100 image file3-2
flash mode2-43
G
gamma characteristics4-14
GeoPort protocolA-2
getting camera compression table2-45
getting camera information2-28
getting camera status2-4
getting color correction matrix2-47
getting information about an image2-4
getting product information2-37
I
ImageAttribute data type4-3, 4-5, 4-21
image capturing functions2-61 to 2-63
image decompression, Windows platform4-2 to 4-4
image processing, banded4-2
Image Processing Module4-2 to 4-24
calculating color tables4-9
callback function4-12
closing4-9
converting images to RGB format4-12
converting thumbnail images to RGB4-10
determining display characteristics4-13
functions4-7 to 4-20
getting camera color correction matrix2-47
getting current camera compression table2-45, 4-18
initializing4-8
opening4-8
setting color matrix4-17
setting default color matrix4-17
setting default display characteristics4-15
setting display characteristics4-14
image resolutions3-2
images
color depth3-3
color format3-3
converting to RGB format4-12
default height2-38
default size2-38
default width2-38
determining characteristics2-30
erasing2-31
memory size in bytes3-3
retrieving2-58
initializing default camera color matrix4-17
initializing default compression table4-20
initializing Image Processing Module4-8
IpCalculateColorTables function4-9
IpConvertADPCMtoRGB function4-11
IpConvertThumbnailToRGB function4-10
IpEndIPM function4-9
IpGetCameraColorMatrix function4-16
IpGetCompressionTable function4-18
IpGetDisplayCharacteristics function4-13
IpInitCameraColorMatrix function4-17
IpInitCompressionTable function4-20
IpInitDisplayCharacteristics function4-15
IpInitIPM function4-8
IPM data types4-4 to 4-7
IpProgressProc callback function4-12
IpSetCameraColorMatrix function4-17
IpSetCompressionTable function4-19
IpSetDisplayCharacteristics function4-14
L
LCD display indicators
battery power1-7
pictures available1-7
pictures taken1-7
M
Macintosh platform, QuickTake 100 software1-3
Macintosh sample code for image retrieval2-5 to 2-7
P
performing asynchronous operations2-8
PICT files5-2
picture mode2-41
pictures
displaying on Macintosh platform5-2
erasing2-31
getting information2-30
ProgressCallBack data type4-22
ProgressCallBack IPM callback function4-7
Q
QTAKE-D.INI file2-26
QuickTake 100 camera
features1-4
making a software connection2-3
QuickTake 100 camera, defined1-2
QuickTake 100 camera serial connectorA-2
QuickTake 100 device driver2-2, 2-3
QuickTake 100 file format, defined3-2
QuickTake 100 QTAKE-D.INI file2-26
QuickTake 100 QuickTime compressor1-2, 5-2
QuickTime Image Compression Manager5-2
R
restoring default camera characteristics2-38
retrieving device driver version number2-36
retrieving images2-4, 2-58
asynchronously2-60
retrieving QuickTake 100 DLL version number2-36
retrieving QuickTake 100 images2-5
retrieving thumbnail images2-55, 2-56
RotateAngle data type4-6, 4-22
S
sample code2-5
serial cablesA-3 to A-6
serial communication, determining baud rate2-26
serial data transfer rate
Macintosh platformA-2
setting, Windows2-26
Windows platformA-2
serial portA-2
data formatsA-2
making a connection2-26
pin assignmentsA-2
protocolsA-2
transfer rateA-2
setting camera color matrix4-17
setting camera date and time2-39
setting camera flash mode2-43
setting camera owner name2-40
setting camera picture mode2-41
setting default display characteristics4-15
setting display characteristics4-14
setting image compression table4-19
setting image resolution1-6
setting sleep mode2-44
sleep mode2-44
T
taking pictures1-6, 2-61 to 2-63
asynchronously2-63
with a timer1-6
technical specificationsB-2
thumbnail images1-2, 2-55, 2-56
converting to RGB format4-10
retrieving2-55
retrieving asynchronously2-56
U
user features1-4 to 1-8
W
camera device driver
for Windows2-2
Windows, setting the host data transfer rate2-26
Windows platform, QuickTake 100 software1-4
X
XYChroma data type4-6, 4-22
This Apple manual was written, edited, and composed on a desktop publishing system using Apple Macintosh computers and FrameMaker software. Line art was created using Adobe Illustrator™ and Adobe Photoshop™.
Text type is Palatino® and display type is Helvetica®. Bullets are ITC Zapf Dingbats®. Some elements, such as program listings, are set in Apple Courier.
WRITER
Steve Schwander
DEVELOPMENTAL EDITORS
Laurel Rezeau, Beverly Zegarski
ILLUSTRATOR
Sandee Karr
PRODUCTION EDITOR
Gerry Gray
Special thanks to Waymen Askey, Alex Crovetto, Paul Hangas, and Alex Pollayil
N * state laws. ° d ONLN dM * f * No licenses, expr úÄ ° d ONLN d^ f ¢ )<ess or implied, ar X ° d ONLN dp £ ® )=e ° d ONLN dr *! ] ( *granted with r `Ä ° d ONLN dÄ ]! £ )3espect to any of the ° d ONLN dï! ** • (( *#technology described in this book. ° d ONLN d∏* *3 E * Apple r ÑÄ ° d ONLN dø* E3 ó )etains all intellectual pr ° d ONLN dŸ* ò3 ± )Soperty ° d ONLN d‡3 *< Ø (: *&rights associated with the technology ° d ONLN d< *E ® * %described in this book. This book is ° d ONLN d+E *N ì * intended to assist application ° d ONLN dJN *W π * (developers to develop applications only ° d ONLN drW *` 6 * for eÄ ° d ONLN dvW 6` ú ) Apple Macintosh computers. ° d ONLN dëd *m f (k *Apple Computer >Ä ° d ONLN düd fm v )<, Inc. ° d ONLN d¶m *v ^ (t *20525 Mariani >Ä ° d ONLN d¥m ^v d )4A ªÄ ° d ONLN dµm cv x )venue ° d ONLN dªv * ^ (} *
Cupertino, CA 6Ä ° d ONLN d»v ^ t )4 95014 ° d ONLN dœ *à W (Ü * 408-996-1010 ° d ONLN d‹å *ï Q *
ed trademark ° d ONLN d^¸ * r ( *of CompuServe, Inc. ° d ONLN dr * ™ * $America Online is a service mark of ° d ONLN dñ * ¢ * Quantum Computer Services, Inc. ° d ONLN d∂ *$ j * FrameMaker is a r øÄ ° d ONLN d« j$ Å )@egister 5 ° d ONLN dŒ Ç$ ≥ )
ed trademark ° d ONLN d€$ *- P (+ *
of Frame T 4 ° d ONLN dÂ$ P- § )&echnology Corporation. ° d ONLN d¸/ *8 É (6 *Helvetica and Palatino ar ÷Ä ° d ONLN d/ É8 ã )Ye r ∞ ° d ONLN d/ å8 £ ) egister %Ä ° d ONLN d / §8 Æ )ed ° d ONLN d"8 *A ¢ (? * trademarks of Linotype Company & ° d ONLN d@8 ¢A § )x. ° d ONLN dBC *L † (J *#Internet is a trademark of Digital ° d ONLN deL *U Ä * Equipment Corporation. ° d ONLN d|W *` * ITC Zapf Dingbats is a r ]Ä ° d ONLN dîW ` ñ )Uegister ” ° d ONLN dõW ñ` † )ed ° d ONLN dû` *i é (g * trademark of International T Δ ° d ONLN d∫` éi ´ )dypeface ° d ONLN d¬i *r W (p * Corporation. ° d ONLN dœt *} : * Micr ˆÄ ° d ONLN d”t :} U )osoft W Ï ° d ONLN d⁄t U} Ç )
indows is a r ıÄ ° d ONLN dÁt Ç} ô )-egister k ° d ONLN dÓt ö} § )ed ° d ONLN dÒ} *Ü j (Ñ *trademark of Micr 'Ä ° d ONLN d} kÜ ´ )Aosoft Corporation. ° d ONLN dà *ë á (è *NuBus ia a trademark of T √ ° d ONLN d.à áë ò )]exas ° d ONLN d3ë *ö : (ò *Instr Û ° d ONLN d8ë :ö V )uments. ° d ONLN d@ú *• π (£ *'Simultaneously published in the United ° d ONLN dg• *Æ m * States and Canada. 4 ^ …¿Y
° d ONLN dz ] … eB ( c …$Even though Apple has reviewed this ° d ONLN dû f … n- * manual, APPLE MAKES NO W a@ ° d ONLN d∂ f- nR )dARRANTY ° d ONLN dæ o … w ˇ ( u … OR REPRESENT {¿ ° d ONLN d o ˇ w )6A I ° d ONLN dÀ o wW )TION, EITHER EXPRESS ° d ONLN d‡ x … ÄO ( ~ …!OR IMPLIED, WITH RESPECT TO THIS ° d ONLN d Å … â * MANUAL, ITS QUALITY f∞ ° d ONLN d Å âH )S
, ACCURACY õÄ ° d ONLN d ÅH âK ),, ° d ONLN d ä … í Ù ( ê …MERCHANT ° d ONLN d( ä Ù í )+ABILITY ≠p ° d ONLN d/ ä íU ) , OR FITNESS FOR A [† ° d ONLN dA äV íW )F ° d ONLN dB ì … õ Õ ( ô …P B ° d ONLN dC ì Õ õ ◊ )AR _† ° d ONLN dE ì ◊ õ/ )
TICULAR PURPOSE. AS A Ñê ° d ONLN dZ ì/ õH )X RESUL ‡ ° d ONLN d` ìH õL )T † ° d ONLN da ìL õO ), ° d ONLN dc ú … § ˝ ( ¢ … THIS MANUAL ° d ONLN dn ú ˛ §N )5 IS SOLD “AS IS,” AND ° d ONLN dÑ • … ≠X ( ´ …!YOU, THE PURCHASER, ARE ASSUMING ° d ONLN d• Æ … ∂Q * "THE ENTIRE RISK AS TO ITS QUALITY ° d ONLN d« ∑ … ø * AND ACCURACY 0 ° d ONLN d” ∑ ø )<. ° d ONLN d’ ƒ … Ã
( …IN NO EVENT WILL ùp ° d ONLN d ƒ
ÃM )D APPLE BE LIABLE ° d ONLN dˆ Õ … ’ ı ( ” …
FOR DIRECT ˇ@ ° d ONLN d Õ Ù ’ )+
, INDIRECT ° d ONLN d
Õ ’A )( , SPECIAL, ° d ONLN d ÷ … fi Ì ( ‹ …INCIDENT ÃÄ ° d ONLN d ÷ Ì fiF )$AL, OR CONSEQUENTIAL K ° d ONLN d 1 ÷G fiH )Z ° d ONLN d 2 fl … Á ( Â …
DAMAGES RESUL )– ° d ONLN d ? fl ÁF )?TING FROM ANY ° d ONLN d M Ë … D ( Ó … DEFECT OR INACCURACY IN THIS ° d ONLN d j Ò … ˘X * +MANUAL, even if advised of the possibility ° d ONLN d ï ˙ … ˇ * of such damages. ° d ONLN d ¶ … ‡ *
THE W e† ° d ONLN d ´ ‡O )ARRANTY AND REMEDIES SET ° d ONLN d ƒ … ◊ ( …FOR  ° d ONLN d « ◊V ) TH ABOVE ARE EXCLUSIVE AND IN ° d ONLN d  …! Ù ( … LIEU OF ALL Q ° d ONLN d ı!, ),
OTHERS, ORAL ¸† ° d ONLN d ˝,!: )7 OR ° d ONLN d
" …*J (( … WRITTEN, EXPRESS OR IMPLIED. No ° d ONLN d
!+ …3 Ú * Apple dealer Ü0 ° d ONLN d
-+ Ú3: )), agent, or employee is ° d ONLN d
E4 …<+ (: … authorized to make any modifi ° d ONLN d
b4+<A )bcation, ° d ONLN d
j= …EC (C …'extension, or addition to this warranty Û` ° d ONLN d
ë=BEC )y. ° d ONLN d
ìJ …RN (P …*Some states do not allow the exclusion or ° d ONLN d
ΩS …[U * .limitation of implied warranties or liability ° d ONLN d
Î\ …dU * ,for incidental or consequential damages, so ° d ONLN d e …mO * *the above limitation or exclusion may not ° d ONLN d An …vC * &apply to you. This warranty gives you ° d ONLN d gw … › * specifi ¿ ° d ONLN d nw fiT )&c legal rights, and you may also have ° d ONLN d îÄ …àO (Ü …,other rights which vary from state to state. 4 ^h¿¯ 4∫h¿¯ ˇ“ @ ˇ ˇˇˇˇ @
° d ONLN d ò ∫ § “ *1Figur R¿ ° d ONLN d ò “ § Ê )es, T è ° d ONLN d ò Â §6 )ables, and Listings |@ ° d ONLN d ( òK §V )fvii
¬ H … 4 √ H … ƒ H ƒ
ˇ·ˇ‚7^
° d ONLN d , ∂ H ¡ m ( æ HPreface
° d ONLN d 4 ≥ ∫ ¬ ‚ )rAbout ∑@ ° d ONLN d : ≥ ‚ ¬ )( This Note
õ‡ ° d ONLN d E µ2 ¡: )Pix ° d ONLN d I … ∫ ’ ( “ ∫Contents of This Note k‡ ° d ONLN d ` …/ ’4 )ux ° d ONLN d b ÷ ∫ ‚3 ( fl ∫Supplementary Documents »¿ ° d ONLN d { ÷G ‚L )çx ° d ONLN d } „ ∫ Ô fi ( Ï ∫For Mor ß ° d ONLN d Ñ „ fi Ô )$
e Information " ° d ONLN d ì „/ Ô7 )Qxi ° d ONLN d ñ ∫ ¸ ¿ ( ˘ ∫T ∫¿ ° d ONLN d ó ø ¸4 )ypographical Conventions %Ä ° d ONLN d ± I ¸S )äxii
, H3 4- H3 . H.
ˇ·ˇ‚7^
° d ONLN d µ H+ x (( H Chapter 1
° d ONLN d ø ∫,Z )rIntroduction to the QuickT 4‡ ° d ONLN d Ÿ Y,¿ )üake 100 Camera
¨ ° d ONLN d È ‘+· ){1-1 ° d ONLN d Ó3 ∫? ⁄ (< ∫QuickT ÄÄ ° d ONLN d Ù3 ⁄?) ) ake 100 Overview Δ‡ ° d ONLN d3=?J )c1-2 ° d ONLN d
@ ∫L ⁄ (I ∫QuickT ÄÄ ° d ONLN d@ ⁄LP ) ake 100 Developer Softwar ”¿ ° d ONLN d)@PLT )ve ù` ° d ONLN d,@iLv )1-3 ° d ONLN d0M ƒY Ú (V ƒ Macintosh ÂÄ ° d ONLN d;MY )B1-3 ° d ONLN d?Z ƒf Œ (c ƒW Û` ° d ONLN d@Z Õf Ì ) indows “` ° d ONLN dHZf )51-4 ° d ONLN dLg ∫s ⁄ (p ∫QuickT ÄÄ ° d ONLN dRg ⁄s ) ake 100 Featur @Ä ° d ONLN d`gs# )@es G ° d ONLN ddg7sD ) 1-4 ° d ONLN dht ƒÄ Ù (} ƒ
User Contr %¿ ° d ONLN drt ıÄ )1ols ¿† ° d ONLN dwtÄ" ) 1-4 ° d ONLN d{Å Œç (ä ŒPower On and Of .‡ ° d ONLN däÅ ç )Nf Ç¿ ° d ONLN dçÅ3ç@ )1-4 ° d ONLN dëé Œö (ó Œ Flash Button t` ° d ONLN düéö' )L1-5 ° d ONLN d£õ Œß (§ ŒErase-All Button Ô` ° d ONLN dµõ+ß8 )]1-6 ° d ONLN dπ® Œ¥ ‘ (± ŒT ° d ONLN d∫® ‘¥ ) imer Button ˚@ ° d ONLN d«® ¥) )H1-6 ° d ONLN dÀµ Œ¡ (æ ŒResolution Button y¿ ° d ONLN dfiµ2¡? )d1-6 ° d ONLN d‚¬ ŒŒ (À ŒShutter Button G¿ ° d ONLN dÚ¬#Œ0 )U1-6 ° d ONLN dˆœ ƒ€ ˝ (ÿ ƒ LCD Display L@ ° d ONLN dœ€ )N1-7 ° d ONLN d‹ ŒË# ( ŒBattery-Power Icon Á¿ ° d ONLN d‹7ËD )i1-7 ° d ONLN d È Œı Ë (Ú ŒPictur ¿ ° d ONLN d%È Ëı ˙ )es-T Å ° d ONLN d)È ˙ı9 )aken Indicator y‡ ° d ONLN d9ÈNı[ )T1-7 ° d ONLN d=ˆ Œ Ë (ˇ ŒPictur ¿ ° d ONLN dCˆ Ë ¸ )es-A 'Ä ° d ONLN dGˆ ¸I )vailable Indicator ¶‡ ° d ONLN d[ˆ]j )a1-7
2 H9 43 H9 4 H4
ˇ·ˇ‚7^
° d ONLN d_& H1 x (. H Chapter 2
° d ONLN di# ∫2 Ê )rQuickT GÄ ° d ONLN do# Â2{ )+ake 100 Driver Software
ˆ@ ° d ONLN d∂5 ÙA )X5-1 ° d ONLN dªI úU º (R úQuickT ÄÄ ° d ONLN d¡I ºU ) ake 100 QuickT 8 ° d ONLN dœI U< )D ime Decompr E‡ ° d ONLN d⁄I<UR )<essor Ò† ° d ONLN d·IfUs )*5-2
Ö *å¯ 4Ü *å¯ á *á¯
ˇ·ˇ‚7^
° d ONLN dÂy *Ñ Z (Å * Appendix “0 ° d ONLN dÓy ZÑ a )0A
° d ONLN dv úÖ » )BQuickT GÄ ° d ONLN dˆv «ÖZ )+ake 100 Serial Interface
† ° d ONLN dxoÑ )®A-1 ° d ONLN då úò (ï ú Serial Port ć ° d ONLN d"å fiò Ó )BA-1 ° d ONLN d&ô ¶• Ø (¢ ¶Pr N† ° d ONLN d(ô ∞• ÷ )
otocol, T ч ° d ONLN d1ô ’•Z )% ransfer Rate, and Data Format ` ° d ONLN dPôn•~ )ôA-2 ° d ONLN dT¶ ¶≤ Δ (Ø ¶QuickT ÄÄ ° d ONLN dZ¶ Δ≤+ ) ake 100 Serial Port Pin ? ° d ONLN dr¶+≤d )e Assignments ∑† ° d ONLN d¶x≤à )MA-2 ° d ONLN dÉ≥ úø ‘ (º ú
Serial Cables Z` ° d ONLN dí≥ Èø ˘ )MA-3 ˇ @ ˇ ˇˇˇˇ @
° d ONLN d ( ù ∫ ®7 )rIntroduction to the QuickT ;† ° d ONLN d B ù7 ®à )}ake 100 Camera
éÄ ° d ONLN d R ùö ®ß )c1-1 ° d ONLN d W ± ∫ º ‰ ( π ∫
Figure 1-1 ° d ONLN d b ± º$ )NQuickT @ ° d ONLN d h ±$ º¿ ) 'ake 100 lens cover in the open position
ê ° d ONLN d ë ±“ ºfl )Æ1-5 ° d ONLN d ï Ω ∫ » ‰ ( ≈ ∫
Figure 1-2 ° d ONLN d † Ω »$ )NQuickT @ ° d ONLN d ¶ Ω$ »‹ ) -ake 100 LCD display and user control buttons å† ° d ONLN d ’ ΩÓ »˚ ) 1-5 ° d ONLN d Ÿ … ∫ ‘ ‰ ( — ∫
Figure 1-3 ° d ONLN d ‰ … ‘h )NRear view of the QuickT ÇÄ ° d ONLN d ˚ …g ‘ß )_ake 100 camera † ° d ONLN d …∫ ‘« )S1-7
¯ H ˛ 4 ˘ H ˛ ˙ ∫ ˙
ˇ·ˇ‚7^
° d ONLN d Ï H ¯ s ( ı H Chapter 2
° d ONLN d Ì ∫ ¯ ‹ )rQuickT ° d ONLN d Ì ‹ ¯Q )"ake 100 Driver Software
Ä ° d ONLN d8 Ìd ¯q )à2-1 ° d ONLN d= ∫ · ( ∫ Table 2-1 ,
Courier . ° d ONLN dG q )NCmSetSleep sleepDelay ° d ONLN d\q π )i parameter values ° d ONLN doÀ › )Z2-44 . ° d ONLN dt
∫ · ( ∫ Table 2-2 ° d ONLN d~
$ )NQuickT @ ° d ONLN dÑ
$˚ ) 4ake 100 driver error category codes, mnemonics, and ° d ONLN d∏" ( defi † ° d ONLN dº"1 )nitions – ° d ONLN d≈C"U ),2-49 ° d ONLN d # ∫. · (+ ∫ Table 2-3 ° d ONLN d‘#.$ )NQuickT @ ° d ONLN d⁄#$. ) 9ake 100 device driver error detail codes, mnemonics, and ° d ONLN d-8 (5defi † ° d ONLN d-83 )nitions Ç ° d ONLN d!-E8W ).2-50 ° d ONLN d&E ∫P Ê (M ∫ Listing 2-1 ° d ONLN d2EP )N@Using the device driver functions to retrieve an image from the ° d ONLN drOZ$ *
QuickT @ ° d ONLN dxO$Zd ) ake 100 camera Ñ` ° d ONLN dàOvZÉ )R2-5
~ HÑ 4 HÑ Ä ∫Ä
ˇ·ˇ‚7^
° d ONLN dår H~ s ({ H Chapter 3
° d ONLN dñs ∫~ ‹ )rQuickT ° d ONLN dús ‹~* )"ake 100 Images
d ° d ONLN d¨s<~I )`3-1 ° d ONLN d±á ∫í · (è ∫ Table 3-1 ° d ONLN dªáíì )N Memory sizes of supported QuickT É0 ° d ONLN d€áíí˘ )äake 100 image formats in ° d ONLN dÙëú (ôbytes ¿ ° d ONLN d˚ë0ú= )(3-3 ° d ONLN dˇù ∫® · (• ∫ Table 3-2 ° d ONLN d ù®∏ )N-Picture display formats and color resolutions ° d ONLN d8ùÀ®ÿ )√3-3
à H“ 4Õ H“ Œ ∫Œ
ˇ·ˇ‚7^
° d ONLN d<¿ HÃ s (… H Chapter 4
° d ONLN dF¡ ∫à )rDisplaying QuickT ÎÄ ° d ONLN dW¡ÃÅ )Wake 100 Images in a W l@ ° d ONLN dl¡ÇÃß )qindows ê ° d ONLN ds¡ßË )% Application
Ì∞ ° d ONLN dÄ¡ÓÃ˚ )G4-1 ° d ONLN dÖ’ ∫‡ · (› ∫ Table 4-1 ° d ONLN dè’‡ô )N Memory and image band processing ` ° d ONLN d±’¨‡π )§4-4 ° d ONLN dµ· ∫Ï · (È ∫ Table 4-2 ° d ONLN dø·Ï4 )N
Default CR W ° d ONLN d…·4Ï9 ),T ≠P ° d ONLN d ·9Ïì ) display characteristics . ° d ONLN d‰·¶Ï∏ )m4-15 ° d ONLN dÈÌ ∫¯ · (ı ∫ Table 4-3 ° d ONLN dÛ̯4 )N
Default CR W ° d ONLN d˝Ì4¯9 ),T ≠P ° d ONLN d˛Ì9¯Ø ) display gamma characteristic . ° d ONLN d ̬¯‘ )â4-15
H" 4 H" ∫
ˇ·ˇ‚7^
° d ONLN d" H t ( H Appendix i‡ ° d ONLN d+ t z ),A
° d ONLN d- ∫ ‹ )FQuickT ° d ONLN d3 ‹ P )"ake 100 Serial Interface
L¿ ° d ONLN dMb p )ÜA-1 ° d ONLN dR% ∫0 Ê (- ∫
Figure A-1 ° d ONLN d]%0$ )NQuickT @ ° d ONLN dc%$0è ) ake 100 serial port location Ü0 ° d ONLN dÅ%°0Ø )}A-1 ° d ONLN dÖ1 ∫< Ê (9 ∫
Figure A-2 ° d ONLN dê1<$ )NQuickT @ ° d ONLN dñ1$<Ø ) $ake 100 serial port physical pattern áê ° d ONLN dº1¡<œ )ùA-1 ° d ONLN d¿= ∫H Ê (E ∫
Figure A-3 ° d ONLN dÀ=H$ )NQuickT @ ° d ONLN d—=$H™ ) !ake 100-to-Macintosh serial cable Ö ° d ONLN dÙ=ºH )òA-3 ° d ONLN d¯I ∫T Ê (Q ∫
Figure A-4 ° d ONLN dIT$ )NQuickT @ ° d ONLN d I$TÓ ) 1ake 100-to-Macintosh serial cable pin assignments p ° d ONLN d<I T )‹A-3 ° d ONLN d@U ∫` Ê (] ∫
Figure A-5 ° d ONLN dKU`$ )NQuickT @ ° d ONLN dQU$`≈ ) (ake 100-to-Macintosh twisted-pair cable ° d ONLN dy_j (gconfi ņ ° d ONLN d~_j; )guration – ° d ONLN dà_Nj\ )3A-4 ° d ONLN dåk ∫v Ê (s ∫
Figure A-6 ° d ONLN dókv$ )NQuickT @ ° d ONLN dùk$vı ) 3ake 100 8-pin mini-DIN to RS-232C serial cable and ° d ONLN d–uÄ& (}adapter ‡ ° d ONLN dŸu9ÄG )1A-4 ° d ONLN d›Å ∫å Ê (â ∫
Figure A-7 ° d ONLN dËÅå$ )NQuickT @ ° d ONLN dÓÅ$å ) ;ake 100 8-pin mini-DIN to D-sub 9-pin RS-232C serial cable ° d ONLN d)ãñI (ìpin assignments É@ ° d ONLN d:ã[ñi )SA-5 ° d ONLN d>ó ∫¢ Ê (ü ∫
Figure A-9 ° d ONLN d \ Í gfi )N=D-sub 9-pin physical pinout on a D-sub 9-pin to D-sub 25-pin ° d ONLN d H f Í q *
adapter cable ¿ ° d ONLN d W f3 qA )IA-6 ° d ONLN d [ r ú } Õ ( z ú Figure A-10 ° d ONLN d g r Í }„ )N>D-sub 25-pin physical pinout on a D-sub 9-pin to D-sub 25-pin ° d ONLN d • | Í á *
adapter cable ¿ ° d ONLN d ¥ |3 áA )IA-6 ° d ONLN d ∏ î ú ü ƒ ( ú ú Table A-1 ° d ONLN d ¬ î Í üV )NSerial port pin assignments † ° d ONLN d fl îi üw )A-2
√ * …¯ 4 ƒ * …¯ ≈ ú ≈¯
ˇ·ˇ‚7^
° d ONLN d „ ∑ * √ ] ( ¿ *
Appendix B
° d ONLN d Ó ∏ ú √ æ )rQuickT ° d ONLN d Ù ∏ æ √3 )"ake 100 Camera Specifi ÉÅ ° d ONLN d
∏3 √U )ucations
]· ° d ONLN d ∏h √v )5B-1 ° d ONLN d à ú ◊ ƒ ( ‘ ú Table B-1 ° d ONLN d" Ã Í ◊ )NV 0 ° d ONLN d# à ◊ ) enus specifi Ö∞ ° d ONLN d/ à ◊; )/cations ê ° d ONLN d8 ÃN ◊\ )/B-2 ˇt @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4⁄ ∫˙ , Palatino
. , (·ix
3, Ã ( # ∫PREF N )3ACE 4 ^ H¿
v H ú 4 v H ú ó H ó
ˇ·ˇ‚7^
ˇˇ¬ò ˇ◊ ° d ONLN d \ ∫ ug ( n ∫About This Note
° d ONLN d ú ∫ ®% *7This developer note defi Œ ° d ONLN d * ú% ®g )knes the QuickT ɇ ° d ONLN d 8 úg ®´ )Bake 100 softwar A` ° d ONLN d G ú¨ ®Î )E
$ogramming interfaces (APIs)—a QuickT G ° d ONLN dI –u ‹ )±!ake 100 camera device driver and ° d ONLN dj › ∫ È Ô ( Ê ∫ an Image Pr ´@ ° d ONLN du › Ô ÈZ )5ocessing Module (IPM). ° d ONLN dç Ô ∫ ˚+ ( ¯ ∫The device driver softwar '† ° d ONLN d¶ Ô, ˚= )re pr 8` ° d ONLN d™ Ô= ˚s ) ovides contr ù` ° d ONLN d∂ Ôs ˚” )6ol services for QuickT 6Ä ° d ONLN dà Ԕ ˚ )`ake 100 digital ° d ONLN d‹ ¸ ∫X ( ∫!computer camera. The camera contr <‡ ° d ONLN d˝ ¸YÖ )ü
ol softwar Ä ° d ONLN d ¸Öü ),e is pr 5† ° d ONLN d ¸† )ovided as a device driver ° d ONLN d( ∫ ( ∫and associated glue fi ≤ ° d ONLN d> )_4les for Macintosh computers and as a driver dynamic ° d ONLN dr ∫"/ ( ∫link library (DLL) for Micr i` ° d ONLN dç/"Q )uosoft W ° d ONLN dîQ" )"(indows. The function names used for the ° d ONLN dº# ∫/ ⁄ (, ∫QuickT ÄÄ ° d ONLN d¬# ⁄/à ) 'ake 100 driver interface and the QuickT C† ° d ONLN dÈ#à/ø )Æ ake 100 DLL 2¿ ° d ONLN dÙ#ø/Û )7
interface ar =‡ ° d ONLN d#Û/˙ )4e ° d ONLN d0 ∫<g (9 ∫&identical for both the Macintosh and W ¿ ° d ONLN d)0g<Õ )≠indows platforms. The I ° d ONLN d?0Õ< )f
APIs for the ° d ONLN dL= ∫I1 (F ∫IPM strictly apply to the W Ê@ ° d ONLN dg=1IÄ )windows platform. ° d ONLN dyO ∫[ ⁄ (X ∫QuickT ÄÄ ° d ONLN dO ⁄[$ ) ake 100 image pr 5Ä ° d ONLN dèO%[n )Kocessing softwar åÄ ° d ONLN düOn[ú )I e decompr <` ° d ONLN d®Où[
. Image pr V† ° d ONLN d!iu™ )-!ocessing is performed by a QuickT † ° d ONLN dBi™u‰ )ô ime decompr ɇ ° d ONLN dMi‰u˝ ):essor ° d ONLN dSv ∫Ç¥ ( ∫3component on the Macintosh computer and by a QuickT ؇ ° d ONLN dÜv≥Ç )˘ake 100 IPM dynamic ° d ONLN döÉ ∫è (å ∫link library for Micr L‡ ° d ONLN dØÉè4 )Xosoft W ˛Ä ° d ONLN d∂É3èë )!indows applications. ° d ONLN dÃï ∫°= (û ∫ This note assumes that you ar Ì ° d ONLN dÈï=°P )Ée alr ‰ ° d ONLN dÓïP°√ )eady familiar with the har Û ° d ONLN dï√°⁄ )sdwar *¿ ° d ONLN d ı )e and ° d ONLN d¢ ∫Æ € (´ ∫softwar ‰¿ ° d ONLN d¢ €Æ˜ )!=e technology of Macintosh computers and computers capable of ° d ONLN dVØ ∫ª Ω (∏ ∫r ^† ° d ONLN dWØ æª ı ) unning Micr d@ ° d ONLN dbØ ıª )7osoft W ‡ ° d ONLN diت[ )"indows softwar Ÿ† ° d ONLN dwØ[ªä )D e. If you ar &` ° d ONLN dÉØ㪠)0 e unfamiliar with Macintosh ° d ONLN düº ∫» € (≈ ∫softwar ‰¿ ° d ONLN d¶º €» )! e and har 1‡ ° d ONLN dغ» )*dwar i† ° d ONLN d≥º »œ ))e, you may want to obtain copies of the r † ° d ONLN d‹º–»Ì )¥elated ° d ONLN d„… ∫’2 (“ ∫ technical manuals listed in ° ° d ONLN dˇ…2’∑ )x“Supplementary Documents,” i‡ ° d ONLN d…∏’¯ )Ü later in this pr
‡ ° d ONLN d*…˘’ )Aeface. ° d ONLN d2€ ∫Á (‰ ∫LWhile every attempt has been made to verify the accuracy of the information ° d ONLN d~Ë ∫Ù √ *
pr G ° d ONLN dÄË ƒÙ )
Iesented, it is subject to change without notice. This developer note may ° d ONLN d…ı ∫< (˛ ∫ contain information or specifi D‡ ° d ONLN dÁı={ )Écations that ar ~‡ ° d ONLN dˆı{˛ )> e still under consideration by ° d ONLN d ∫ ( ∫Apple Computer (Ä ° d ONLN d#G )K. The primary r ‹ ° d ONLN d2Gu )B eason for r ™† ° d ONLN d=v¶ )/ eleasing pr Û@ ° d ONLN dH¶› )0 eliminary pr ‰@ ° d ONLN dT›¯ )7oduct ° d ONLN dZ ∫ ( ∫information is to pr _¿ ° d ONLN dnÈ )V/ovide the developer community with essential pr ƒ@ ° d ONLN dùÈ )Ÿoduct ° d ONLN d£ ∫( ÷ (% ∫specifi Ó ° d ONLN d™ ÷( ) cations, theory ≈‡ ° d ONLN dπ (Î )@1, and application information for the purpose of ° d ONLN dÍ) ∫5Z (2 ∫#stimulating work on compatible thir ≠ ° d ONLN d
)Z5á )†
d-party pr * ° d ONLN d)à5™ ).oducts.
C HQ 4D HQ , Helvetica
° d ONLN d B ∫M Õ (J ∫Note
ˇ·ˇ‚7^
° d ONLN d%O ∫[ ı *
Information r ˆÄ ° d ONLN d2O ı[ );egar @ ° d ONLN d6O [) )ding W l@ ° d ONLN d<O)[™ ) indows development softwar † ° d ONLN dVO´[— )Ç
the featur ` ° d ONLN d ≥ ∏ « ƒ )+es of the QuickT 7@ ° d ONLN d √ ∏ ƒ¢ )G!ake 100 digital computer camera. ° d ONLN d  ú ÷ Ú ( ” úChapter 2, “QuickT Ȇ ° d ONLN d ˜ Ò ÷V )Uake 100 Driver Softwar $† ° d ONLN d
W ÷c )fe,” n@ ° d ONLN d c ÷o ) pr µ` ° d ONLN d o ÷„ ) ovides an overview of the ° d ONLN d- ◊ ú „ º ( ‡ úQuickT ÄÄ ° d ONLN d3 ◊ º „= ) ake 100 device driver softwar E ° d ONLN dP ◊> „b )Çe and pr √ ° d ONLN dX ◊b „› )$esents guidelines and some ° d ONLN ds ‰ ú 1 ( Ì ú!sample code for using the softwar ` ° d ONLN dî ‰2 [ )ñ
e to contr [` ° d ONLN dû ‰[ ó ))
ol the QuickT ó ° d ONLN d´ ‰ñ ı );ake 100. This chapter ° d ONLN d¡ Ò ú ˝" ( ˙ ú also describes the device contr `Ä ° d ONLN d‡ Ò" ˝« )Ü$ol functions supported by the QuickT VÄ ° d ONLN d Ò« ˝Í )•ake 100 ° d ONLN d ˛ ú
6 ( ú!device driver for Macintosh and W â ° d ONLN d- ˛6
Application,” €† ° d ONLN d{IÂUÁ )< ° d ONLN d|V úb • (_ úpr G ° d ONLN d~V ¶bZ )
(ovides a high-level overview of image pr ‡ ° d ONLN d¶V[bò )µocessing on a ° d ONLN d¥c úo ¶ (l úW Û` ° d ONLN dµc •o' ) indows-compatible computer ¿ ° d ONLN dœc'oè )Ç. It also describes the W S ° d ONLN dËcèo€ )hindows IPM DLL •‡ ° d ONLN dˆc€o› )L ° d ONLN d˜p ú|( (y ú functions that support image pr Ä ° d ONLN dp(|£ )å ocessing. These functions ar 5` ° d ONLN d2p§|“ )| e used for ° d ONLN d=} úâz (Ü ú0gathering information about images in the QuickT ¿ ° d ONLN dm}zâ‚ )fiake 100 and displaying ° d ONLN dÑä úñ6 (ì ú!those images on the host computer –¿ ° d ONLN d•ä5ñ: )ô. ° d ONLN d®ú ú®% (• ú Chapter 5, “Displaying QuickT ¿ ° d ONLN d≈ú%®Æ )â ake 100 Images in a Macintosh † ° d ONLN d„ú≠®Ë )à
A, “QuickT ¸† ° d ONLN dn» ¸‘h )1ake 100 Serial Interface,” fi` ° d ONLN dà»i‘ˆ )m includes information about the ° d ONLN d®’ ú· º (fi úQuickT ÄÄ ° d ONLN dÆ’ º·è ) 0ake 100 serial connector and supported serial pr ʆ ° d ONLN dfi’è·– )”otocols. It also ° d ONLN dÔ‚ úÓ • (Î úpr G ° d ONLN dÒ‚ ¶ÓÒ )
° d ONLN dS| úà ¢ (Ö úT µ¿ ° d ONLN dT| °àÒ )Jo supplement the information in this developer note, Macintosh developers ° d ONLN dûâ úï# (í ú should have copies of the appr @ ° d ONLN dºâ$ïE )àopriate óÄ ° d ONLN dƒâEïf )!Apple r Z ° d ONLN dÀâgïw )"efer ° d ONLN dœâxïà )ence manuals. The ° d ONLN d·ñ ú¢ (ü úfollowing documents ar ÎÄ ° d ONLN d˜ñ¢í )i e essential to Macintosh softwar ) ° d ONLN dñì¢◊ )ée development: ˇû @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4⁄ ∫˙ , Palatino
. , (·xi
3, Ã ( # ∫PREF N )3ACE 4 ^ H¿
° d ONLN d \ ∫ h ¿ ( e ∫T ° d ONLN d \ ø h Ú )
echnical Intr Ç ° d ONLN d \ Ú hz )3 oduction to the Macintosh Family ”` ° d ONLN d . \y hç )á, thir îÄ ° d ONLN d 4 \é h )d edition, surveys the ° d ONLN d K i ∫ ux ( r ∫)complete Macintosh family of computers fr H ° d ONLN d t iy uΔ )øom the developer ù¿ ° d ONLN d Ñ i« u )N’s point of view #` ° d ONLN d î i u )D. ° d ONLN d ó { ∫ áZ ( Ñ ∫$Macintosh Human Interface Guidelines è† ° d ONLN d ª {Z áf )† pr ÷¿ ° d ONLN d æ {f á ) 'ovides authoritative information about ° d ONLN d  à ∫ îΔ ( ë ∫;the theory behind the Macintosh “look and feel” and standar *¿ ° d ONLN d à« î ( ë«d ways of using ° d ONLN d0 ï ∫ °N ( û ∫!individual interface components. ° d ONLN dR ß ∫ ≥ ˇ *Inside Macintosh b ° d ONLN db ß ≥t )F is a collection of books, or ¨ ° d ONLN d ßt ≥
)t$ganized by topic, that describe the ° d ONLN d£ ¥ ∫ ¿ ¸ ( Ω ∫system softwar M‡ ° d ONLN d± ¥ ˝ ¿z )Ce of Macintosh computers. T ˙¿ ° d ONLN dà ¥y ¿ö )|ogether €† ° d ONLN d” ¥ö ¿fl )!, these books pr ≈Ä ° d ONLN d„ ¥fl ¿ )Eovide a ° d ONLN dÎ ¡ ∫ Õ ÷ ( ∫compr ‡ ° d ONLN d ¡ ◊ Õ )
ehensive r ° d ONLN d˙ ¡ Õ )-efer Ω@ ° d ONLN d˛ ¡ Õt )ence for Macintosh pr ˙¿ ° d ONLN d ¡t ÕÕ )`ogrammers, softwar ¯ ° d ONLN d% ¡Õ Õ )Y
e designers, ° d ONLN d2 Œ ∫ ⁄" ( ◊ ∫and engineers. The curr ˛† ° d ONLN dI Œ" ⁄w )hent volume titles ar & ° d ONLN d] Œx ⁄| )Ve ° d ONLN d_ ‡ ∫ Ï, ( È ∫Inside Macintosh: Overview ° d ONLN dz Ì ∫ ˘8 *
e Macintosh T Æ ° d ONLN dÀ ˙Oh )9oolbox ° d ONLN d“ ∫ ( ∫Inside Macintosh: Files ° d ONLN dÍ ∫ *
Inside Macintosh: Pr 3¿ ° d ONLN d˛ * )Uocesses ° d ONLN d! ∫-' (* ∫Inside Macintosh: Memory ° d ONLN d . ∫:2 *
Inside Macintosh: Imaging W ` ° d ONLN d:.3:p )y
ith QuickDraw ° d ONLN dH; ∫G
(D ∫Inside Macintosh: T b ° d ONLN d[;
G )Pext ° d ONLN d_H ∫Tâ (Q ∫0Inside Macintosh: Interapplication Communication ° d ONLN dêU ∫a# *
Inside Macintosh: QuickT ê‡ ° d ONLN d®U#a1 )iime ° d ONLN d¨b ∫n# (k ∫Inside Macintosh: QuickT ê‡ ° d ONLN dƒb#nf )iime Components ° d ONLN d”o ∫{5 (x ∫ Inside Macintosh: Networking ° d ONLN dÅ ∫çö *4Designing Cards and Drivers for the Macintosh Family ∑ ° d ONLN d$Åôç≠ )fl, thir x@ ° d ONLN d*ÅÆç )d edition, explains the ° d ONLN dBé ∫ö » (ó ∫har ` ° d ONLN dEé …ö ‡ )dwar N ° d ONLN dIé ‡ö )
e and softwar i† ° d ONLN dVé ö' )<e r x@ ° d ONLN dYé'ö> ) equir èÄ ° d ONLN d^é>ö ),ements for drivers and NuBus™ ‘90 accessory ° d ONLN däõ ∫ß « (§ ∫car µ@ ° d ONLN dçõ «ßÉ )
(ds compatible with Macintosh computers. ° d ONLN d∂≠ ∫π ¿ (∂ ∫T µ¿ ° d ONLN d∑≠ øπ¥ )6o supplement the information in this developer note, W ` ° d ONLN dÌ≠µπ )ˆindows developers ° d ONLN dˇ∫ ∫ΔA (√ ∫ should have copies of the appr @ ° d ONLN d ∫BΔx )à opriate Micr à¿ ° d ONLN d)∫xΔö )6osoft W :` ° d ONLN d0∫öΔ« )" indows pr `Ä ° d ONLN d9∫«Δ˝ )-
° d ONLN d÷# ∫/ ◊ (, ∫APDA H¿ ° d ONLN d⁄# ◊/ „ ) is ¿ ° d ONLN dfi# „/O ) Apple’s worldwide sour ¯ ° d ONLN dÙ#N/å )kce for over thr ¿ ° d ONLN d#ç/¥ )?ee hundr º† ° d ONLN d #¥/˛ )'ed development ° d ONLN d0 ∫< (9 ∫tools, technical r w¿ ° d ONLN d,0< )Hesour ¿ ° d ONLN d10<\ )ces, training pr µ† ° d ONLN dA0\<˚ )B#oducts, and information for anyone ° d ONLN dd= ∫I Œ (F ∫inter
ools Catalog ~ ° d ONLN d—JMVó )4featuring all curr @ ° d ONLN d„JòV€ )Kent versions of Ù` ° d ONLN dÛJ⁄V˜ )BApple ° d ONLN d˘W ∫cÄ (` ∫+development tools and the most popular thir È¿ ° d ONLN d$WÄc˙ )Δd-party development tools. ° d ONLN d?d ∫p ≈ (m ∫Or ‡ ° d ONLN dAd Δp ) dering is easy; ther ü@ ° d ONLN dUdp) )Se ar ≠‡ ° d ONLN dYd)p˚ ).e no membership fees, and application forms ar Δ‡ ° d ONLN dád˚p )“e not ° d ONLN dçq ∫} Ω (z ∫r E ° d ONLN déq æ} ’ )equir \@ ° d ONLN dìq ’}/ )ed for most of the pr ¥` ° d ONLN d®q/}Q )Zoducts. fi ° d ONLN d∞qQ}n )"APDA ¶¿ ° d ONLN d¥qn}y ) of ¬Ä ° d ONLN d∑qy}¸ ) fers convenient payment and ° d ONLN d”~ ∫är (á ∫+shipping options, including site licensing. ° d ONLN dˇê ∫ú ¿ *T µ¿ ° d ONLN d ê øú – )o or ¿ ° d ONLN dê –ú Î )der pr ‡ ° d ONLN d
° d ONLN d \ ú h π ( e úAPDA H¿ ° d ONLN d \ π h ª ) ° d ONLN d i ú u Á ( r úApple Computer (Ä ° d ONLN d i Á u ˛ )K, Inc. ° d ONLN d v ú Ç ¢ ( úP ?† ° d ONLN d v ° Ç “ ) .O. Box 319 ° d ONLN d ) É ú è ´ ( å úBuf … ° d ONLN d , É ´ è œ )falo, NY G† ° d ONLN d 4 É – è )% 14207-0319
° d ONLN d+P ú\° (Y ú:This developer note uses typographical conventions that ar » ° d ONLN deP°\… (Y° e standar C@ ° d ONLN dnP \› ))d in ° d ONLN ds] úi Ú (f úApple publications. ° d ONLN dáo ú{Ç *6All code listings and the names of the actual data str 4† ° d ONLN dΩoÉ{ö )Áuctur ∫Ä ° d ONLN d¬oö{‹ )es, constants, fi U ° d ONLN d”o›{Ù )Celds, . ° d ONLN dŸ| úà Ï (Ö úparameters, and r R` ° d ONLN dÍ| Ïà )P
outines ar $¿ ° d ONLN dÙ|àq ),e shown in Courier ( ,
Courier $¿ ° d ONLN d|qàÀ )Ythis is Courier $¿ ° d ONLN d|Àà‘ )Z). . ° d ONLN dé úö (ó úHexadecimal numbers ar ∞` ° d ONLN d1é ö )oe pr ¡ ° d ONLN d5é ö· ).eceded by a dollar sign ($). For example, the ° d ONLN dcõ úßê (§ ú8hexadecimal equivalent of decimal 16 is written as $10.
µ *√¯ 4∂ *√¯ , Helvetica
° d ONLN dú¥ úø Ø *Note
ˇ·ˇ‚7^
° d ONLN d°¡ úÕ £ *A ∫† ° d ONLN d¢¡ £Õq )2 note like this contains information that is inter " ° d ONLN d‘¡rÕŸ )œesting but not essential ° d ONLN dÌÕ úŸ+ (÷ ú!for an understanding of the text. ,
Zapf Dingbats
ë ° d ONLN d–0ÿ6 )îu
fl ° d ONLN dÕ6Ÿ8 )
Ê *Ù¯ 4Á *Ù¯
° d ONLN dÁ úÔ ª (Ì úIMPORT Ä ° d ONLN dÁ ªÔ À ) ANT
ˇ·ˇ‚7^
° d ONLN d Ú ú˛ £ (˚ úA ∫† ° d ONLN d Ú £˛∫ )@ note like this contains important information that you should r NÄ ° d ONLN d]Úª˛Õ (˚ªead ° d ONLN da˛ ú
ˇˇ—Ú ˇÆ ( @ lIntroduction to the QuickT Ÿ$ )aake 100 Camera 4⁄ *˙¯
(‡ *1-2
)BQuickT @ ) ake 100 Overview 4 ^ *¿¯
° d ONLN d \ l h) ( e l*This chapter gives a summary of the featur æ‡ ° d ONLN d * \) hq )Ωes of the QuickT Ï¿ ° d ONLN d : \p h∏ )Gake 100 camera. Á† ° d ONLN d J \∏ hÙ )H An overview ° d ONLN d V i l u ‘ ( r lof how to use the featur 6@ ° d ONLN d n i ’ u )ies of the QuickT d ° d ONLN d ~ i up )Gake 100 driver is pr † ° d ONLN d í iq uù )U
ovided in ¡† ° d ONLN d ú iù uÕ ), Chapter 2, ° d ONLN d ß v l Ç ë ( l“QuickT ÄÄ ° d ONLN d Æ v ë Ç ˆ )%ake 100 Driver Softwar ªÄ ° d ONLN d ƒ v ˆ Ç )ee.” ° d ONLN d « v Ç )
The QuickT º@ ° d ONLN d Ï ≈ ü — )3Nake 100 is a portable, fully automatic, hand-held digital computer camera. It ° d ONLN d: “ l fi | ( € lstor 9‡ ° d ONLN d> “ } fi • )es compr A` ° d ONLN dF “ • fi~ )(2essed 24-bit color still images in internal memory *Ä ° d ONLN dx “} fi≠ )ÿ . Images ar 7¿ ° d ONLN dÉ “≠ fi– )0e captur @ ° d ONLN dã “— fifi )$ed ° d ONLN dé fl l Î ∫ ( Ë lusing the same pr ° d ONLN dü fl ª Î' )Oocess used to take pictur @ ° d ONLN d∏ fl' ÎÎ )l)es with any hand-held camera—aim at your ° d ONLN d· Ï l ¯ ™ ( ı lsubject and pr ” ° d ONLN dÔ Ï ™ ¯Å )>2ess a button to open the shutter and take a pictur `‡ ° d ONLN d! ÏÇ ¯˜ )ÿe. The internal memory in ° d ONLN d; ˘ l – ( lthe camera acts like a r º ° d ONLN dS ˘ – Ô )doll of fi ÿ` ° d ONLN d\ ˘ Ô! ) lm that stor §¿ ° d ONLN dh ˘"ê )3es the images by number $† ° d ONLN d ˘ê¯ )n. In addition to manual ° d ONLN dó l Ç ( lcontr >Ä ° d ONLN dú É ¡ )ol, the QuickT ˙@ ° d ONLN d™ ¿, )=ake 100 can also be contr ø@ ° d ONLN d√-Ó )m-olled over a serial cable by a host computer ° d ONLN d l ∏ ( lusing the softwar O ° d ONLN d π R )M$e described in this developer note. ° d ONLN d&% l1 † (. l
The QuickT º@ ° d ONLN d0% ü1 Ã )3
ake 100 pr ‹ ° d ONLN d:% Ã1‡ )-@ovides a simple solution for capturing and transferring digital ° d ONLN dz2 l> ‡ (; limages to a host computer TÄ ° d ONLN dì2 ‡>ç )t). Using a serial interface, images captur Ñ¿ ° d ONLN dº2ç>˜ )≠ed in the camera can be ° d ONLN d‘? lK o (H lr E ° d ONLN d’? pKÈ )Uetrieved by the host computer without the need of an intermediary digitizing device, ° d ONLN d*L lX: (U l.such as a scanner or frame-capturing video car Ö@ ° d ONLN dXL:Xy )Œ
d. The QuickT ›@ ° d ONLN deLxX‘ )>ake 100 serial port is ° d ONLN d|Y le § (b l
described in ` ° d ONLN dâY •e ‘ )9 Appendix …@ ° d ONLN díY ”e ).
A, “QuickT ë ° d ONLN dúYeq )2ake 100 Serial Interface.” r¿ ° d ONLN d∂Yret )m ° d ONLN d∏k lw å (t lQuickT ÄÄ ° d ONLN dæk åw ⁄ ) ake 100 images ar p` ° d ONLN dœk ⁄w ˝ )Ne captur :‡ ° d ONLN d◊k ˛w= )$ed in two user ;† ° d ONLN dÂk=wQ )?-defi ņ ° d ONLN dÍkQwÄ ) ned pixel r ¬Ä ° d ONLN dıkÄwÁ )/esolutions—640 by 480 ° d ONLN d x lÑA (Å l0and 320 by 240. Images with 640 by 480 pixels ar ˝ ° d ONLN d;xAÑL )’e r ¿ ° d ONLN d>xMÑa ) eferr ™Ä ° d ONLN dCxaÑÖ ) ed to as ¿ ° d ONLN dLxÜÑû )%high-r ’‡ ° d ONLN dRxûÑ„ )esolution images. D@ ° d ONLN dcx‰ÑÊ )F ° d ONLN ddÖ lë ˚ (é l Images with 320 by 240 pixels ar y@ ° d ONLN dÑÖ ˚ë )èe r ᇠ° d ONLN dáÖë ) eferr &† ° d ONLN dåÖë? ) ed to as ć ° d ONLN dïÖ?ëi )$
standard-r Ä ° d ONLN düÖjëØ )+esolution images. ɇ ° d ONLN d∞ÖØë )E The QuickT @ ° d ONLN dªÖÂëˆ )6ake ° d ONLN døí lû (õ l 100 camera has a 1 MB memory ar Õ¿ ° d ONLN dfiíûî )ó!ea for image storage and can stor ë` ° d ONLN dˇíïû— )íe a total of 32 ° d ONLN dü l´ ç (® lstandar ±Ä ° d ONLN dü ç´ ö )!d-r Ê ° d ONLN dü ö´ )
esolution images, 8 high-r H† ° d ONLN d3ü
´€ )s/esolution images, or a combination of the two. ° d ONLN dc± lΩ (∫ l&In addition, a thumbnail image is stor Œ` ° d ONLN dâ±Ωá )¶ed with each image captur ® ° d ONLN d¢±áΩñ )ued. / ° d ONLN d¶±óΩû )A i¿ ° d ONLN dß±ûΩÓ ) thumbnail image ° d ONLN d∏æ l ° (« l
has a pixel r òÄ ° d ONLN d≈æ ° ^ )5*esolution of 80 by 60. Thumbnail images ar d ° d ONLN dÔæ_ ù )æe useful for pr Ň ° d ONLN d˛æù ÿ )>
eviewing the ° d ONLN d À l◊ œ (‘ lcontents of an image fi PÄ ° d ONLN d"À –◊ ‹ )dle. ° d ONLN d'› lÈ ™ (Ê l
The images ar R‡ ° d ONLN d4› ™È ¬ )>e stor V` ° d ONLN d:› ¬È< )ed in the camera in a compr ° d ONLN dU›=Ⱥ ){ essed format that cannot be r ¿† ° d ONLN dr›ºÈÒ ) eadily used ° d ONLN d~Í lˆ … (Û lby the host computer æ† ° d ONLN díÍ …ˆ Ó )]. QuickT ø ° d ONLN döÍ Óˆ\ )%ake 100 images must be r Z¿ ° d ONLN d≤Í]ˆã )o etrieved fr /‡ ° d ONLN dΩÍãˆı ).om the camera with the ° d ONLN d‘˜ l å ( lQuickT ÄÄ ° d ONLN d⁄˜ å · ) ake 100 driver DLL H‡ ° d ONLN dϘ ·` )U functions and then decompr ñ@ ° d ONLN d˜`… )essed with the Image Pr I† ° d ONLN d ˜ Ò )j ocessing ° d ONLN d' lÕ (
lLModule (IPM) functions prior to displaying them within an application window e@ ° d ONLN dsÕ“ (
Õ. ° d ONLN dv l"E ( l.On the Macintosh computer the IPM functions ar |¿ ° d ONLN d§E"ƒ )Ÿ e incorporated into a QuickT ‹† ° d ONLN d¿√"Ê )~ake 100 ° d ONLN d»# l/ å (, lQuickT fi‡ ° d ONLN dŒ# å/ Δ ) ime decompr K ° d ONLN dŸ# «/ › );essor 9Ä ° d ONLN dfi# ›/ Î ). Pr ° d ONLN d‚# Ï/à )0ograms written for the Macintosh use the decompr 2` ° d ONLN d #Ã/ )‡ essor to ° d ONLN d 0 l< ì (9 ldecompr Ê@ ° d ONLN d "0 ì< œ )'
ess the compr à ° d ONLN d /0 –< )=essed raw QuickT ˚@ ° d ONLN d ?0 <· )N,ake 100 image data so that the image can be ° d ONLN d k= lI (F l#displayed on the Macintosh computer Æ ° d ONLN d é=I: )ß . Standar ‚` ° d ONLN d ó=:Ic )'d QuickT › ° d ONLN d ü=cIí )) ime compr c‡ ° d ONLN d ®=ìIÀ )0essor calls ar R† ° d ONLN d ∂=ÀIÈ )8e used ° d ONLN d ΩJ lV ≥ (S lfor the decompr † ° d ONLN d ÃJ ≥V )Gession and display pr ·Ä ° d ONLN d ·JV- )^ocess. ° d ONLN d È\ lh s (e lA ∫† ° d ONLN d Í\ sh ) W Æ ° d ONLN d Ï\ h ∂ )
indows DLL £` ° d ONLN d ˆ\ ∂h ¬ )7 pr ÍÄ ° d ONLN d ˘\ ¬h+ ) ovides the IPM for Micr † ° d ONLN d
\,hN )josoft W Ã@ ° d ONLN d
\Mh| )! indows. W † ° d ONLN d
\}h™ )0 indows pr D¿ ° d ONLN d
)\™hÔ )-ograms use the ° d ONLN d
8i lu – (r lfunctions described in fl† ° d ONLN d
Oi –uY )d Chapter 4, “Displaying QuickT n` ° d ONLN d
liYuª )âake 100 Images in a W <Ä ° d ONLN d
Åiªufi )bindows ° d ONLN d
àv lÇ ß ( l
Application,” ~ ° d ONLN d
ïv ®Ç › )< to decompr ú@ ° d ONLN d
†v ›ÇT )5ess and display the QuickT e† ° d ONLN d
∫vTÇ◊ )w ake 100 raw image data in an ° d ONLN d
◊É lè Ä (å lappr I@ ° d ONLN d
€É Åè Ë )opriate display format. ° d ONLN d
Ùï l°“ (û lQFor a discussion of what your application needs to do to interact with the QuickT ¿ ° d ONLN d Eï“°ı (û“ake 100 ° d ONLN d M¢ lÆ ° (´ l camera, see –¿ ° d ONLN d Y¢ °Æ Ù )5“Using the QuickT ˚¿ ° d ONLN d j¢ ÛÆX )Rake 100 Driver Softwar 6¿ ° d ONLN d Ä¢YÆ∫ )fe” beginning on page VÄ ° d ONLN d ï¢∫Æ« )a2-3 ™` ° d ONLN d ò¢«Æà )
. ˇÿ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER à )>1 , Helvetica
ˇˇ—Ú ˇÆ ( @ äIntroduction to the QuickT Ÿ$ )aake 100 Camera 4⁄ ä˙ (‡ äQuickT @ ) ake 100 Developer Software
The QuickT º@ ° d ONLN d , ô Ω •0 )3ake 100 developer softwar k@ ° d ONLN d E ô1 • )t0e is available for both Macintosh computers and ° d ONLN d u ¶ ä ≤ û ( Ø äMicr ‡ ° d ONLN d y ¶ ü ≤ ¡ )osoft W ƒÄ ° d ONLN d Ä ¶ ¿ ≤l )!$indows compatible computers. The har îÄ ° d ONLN d § ¶m ≤Ñ )≠dwar Ã@ ° d ONLN d ® ¶Ñ ≤¿ )
e and softwar Á¿ ° d ONLN d µ ¶¿ ≤À )<e r ˆ` ° d ONLN d ∏ ¶À ≤‚ ) equir
† ° d ONLN d Ω ¶„ ≤ˇ )ed for ° d ONLN d ƒ ≥ ä ø fl ( º ädeveloping QuickT ˛† ° d ONLN d ’ ≥ fi øï )T'ake 100 applications on Macintosh and W X ° d ONLN d ¸ ≥ñ ø )∏indows platforms is listed ° d ONLN d ¿ ä à … ( … äin this section.
Ò H ¯ 4 Ú H ¯ Û ä Û
ˇ·ˇ‚7^
ˇˇ‹. ˇ◊ ° d ONLN d( ‚ ä Ò » *$ Macintosh ˇˇˇˇˇˇ €r ( Ì1
° d ONLN d3 ˝ ä æ ( ä
The QuickT º@ ° d ONLN d= ˝ Ω 9 )3ake 100 driver and image pr ∑† ° d ONLN dX ˝9 Ç )|ocessing softwar † ° d ONLN dh ˝É ¯ )Je work with the following ( ° d ONLN dÇ ˝¯ )uApple ° d ONLN dà
ä ˝ ( äMacintosh computer confi k ° d ONLN d†
˛- )t gurations: ,
Zapf Dingbats
° d ONLN d¨ ä' è (& än
° d ONLN dÆ ñ) ) computers with a Motor π` ° d ONLN dƒ )A )kola 68020 or gr SÄ ° d ONLN d” B)o )A eater CPU
° d ONLN d›2 ä9 è (8 än
° d ONLN dfl/ ñ; € ) System 7.0.1• T µ‡ ° d ONLN dÓ/ ⁄;ô )D+une-Up or a later version of system softwar *` ° d ONLN d/ö;û )¿e
° d ONLN dD äK è (J än
° d ONLN d A ñM ’ ) 5 MB of RAM ° d ONLN d*R ä^ æ ([ ä
The QuickT º@ ° d ONLN d4R Ω^
)3ake Image QuickT ˇ ° d ONLN dDR
^G )P ime decompr k` ° d ONLN dORH^• );essor and the QuickT b ° d ONLN dcR•^ )]ake 100 glue code and ° d ONLN dy_ äk ∞ (h äheader fi ¿ ° d ONLN dÇ_ ±k Ô )'
° d ONLN d Ü x í ò ) QuickT ÄÄ ° d ONLN d ˆ Ü ò í Î ) ake Setup—a contr Ï¿ ° d ONLN d Ü Î í¬ )S/ol panel for mounting the camera on the desktop
∂ * Ω¯ 4 ∑ * Ω¯ ∏ l ∏¯
ˇ·ˇ‚7^
ˇˇ‹. ˇ◊ ° d ONLN d7 ß l ∂ y ( ≤ lW íÓ ° d ONLN d8 ß y ∂ £ )
indows ˇˇˇˇˇˇ €r ( ≤1
° d ONLN d@ ¬ l Œ † ( À l
The QuickT º@ ° d ONLN dJ ¬ ü Œ Ù )3ake 100 driver DLL ц ° d ONLN d\ ¬ Ù Œ1 )U
and image pr Œ ° d ONLN di ¬1 Œl )= ocessing DLL V† ° d ONLN du ¬m Œë )< softwar ;` ° d ONLN d} ¬ë ŒŸ )$e work with the ° d ONLN dç œ l € ≠ ( ÿ lfollowing Micr B` ° d ONLN dõ œ Æ € – )Bosoft W Ù ° d ONLN d¢ œ œ € )! indows confi ‡ ° d ONLN dÆ œ €8 ): gurations:
° d ONLN d∫ Â l Ï q ( Î ln
° d ONLN dº ‚ x Ó Ç ) W Û` ° d ONLN dΩ ‚ Å Ó ” ) indows 3.1 or later
° d ONLN d— ˜ l ˛ q ( ˝ ln
° d ONLN d” Ù x  ) Intel i80386, i80486, or gr 1@ ° d ONLN dÓ Ù Ê )n
eater CPU
° d ONLN d˘ l q ( ln
° d ONLN d˚ x ∑ ) 4 MB of RAM ° d ONLN d l# Õ ( lThe following softwar P ° d ONLN d Œ# )be components ar ˚¿ ° d ONLN d,#! )He r
` ° d ONLN d/"#9 ) equir !† ° d ONLN d49#Z )ed to cr Ù ° d ONLN d<Y#w ) eate W Ω ° d ONLN dBw#Œ ) indows-compatible ° d ONLN dT$ l0 ‰ (- lapplications for the QuickT ç¿ ° d ONLN do$ ‰0) )xake 100 camera:
° d ONLN d: lA q (@ ln
° d ONLN dÅ7 xC ò ) QuickT ÄÄ ° d ONLN dá7 òC Ì ) ake 100 driver DLL H‡ ° d ONLN dô7 ÌC) )U
and header fi 5¿ ° d ONLN dß7*CE )=le (QT ˙‡ ° d ONLN d≠7DCz ) AKE-D.DLL GÄ ° d ONLN d∂7{Cû )7 and QT s‡ ° d ONLN dΩ7ûCÃ )#AKE-D.H)
° d ONLN dΔL lS q (R ln
° d ONLN d»I xU ò ) QuickT ÄÄ ° d ONLN dŒI òU ‰ ) ake 100 IPM DLL Õ ° d ONLN d›I ‰U )L
and header fi π‡ ° d ONLN dÎI!U< )=le (QT ° d ONLN dÒI<Un ) AKE-I.DLL l‡ ° d ONLN d˙InUë )2 and QT ô@ ° d ONLN dIëU∫ )#AKE-I.H)
The QuickT º@ ° d ONLN d-ó ü£, )3 ake 100 camera has many featur ` ° d ONLN dKó-£U )é
es that ar & ° d ONLN dUóU£è )(e easily contr ¿ ° d ONLN dcóè£ÿ ):olled by the user ˜Ä ° d ONLN dtó◊£Â )H. It ° d ONLN dy§ l∞ ˜ (≠ l also has an LCD display that pr ¬† ° d ONLN dò§ ˜∞ı )ã:ovides visual feedback about various internal conditions.
’ *‹¯ 4÷ *‹¯ ◊ l◊¯
ˇ·ˇ‚7^
ˇˇ‹. ˇ◊ ° d ONLN d”Δ l’ ø (— l
User Controls ˇˇˇˇˇˇ €r (—1
° d ONLN d‚· lÌ † (Í l
The QuickT º@ ° d ONLN dÏ· üÌ< )3#ake 100 camera has these user contr Δ¿ ° d ONLN d·<ÌM )ùols:
° d ONLN d˜ l˛ q (˝ ln
° d ONLN dÙ x ¡ ) power on and of Z† ° d ONLN d&Ù ¡ ƒ )If
° d ONLN d( l q ( ln
° d ONLN d* x ~ ) fl å¿ ° d ONLN d, ~ ¨ )
ash button
° d ONLN d7 l" q (! ln
° d ONLN d9 x$ º ) erase-all button
° d ONLN dJ- l4 q (3 ln
° d ONLN dL* x6 Ø ) timer button
° d ONLN dY? lF q (E ln
° d ONLN d[< xH { ) r E ° d ONLN d\< |H ƒ )esolution button
° d ONLN dmQ lX q (W ln
° d ONLN doN xZ ∑ ) shutter button ° d ONLN d~_ lk ü (h l These contr ć ° d ONLN dâ_ ük ∑ )3ols ar `¿ ° d ONLN dè_ ∑kZ )&e described in the following sections.
â *ê¯ 4ä *ê¯ ã lã¯
ˇ·ˇ‚7^
° d ONLN d∂| lä » (Ü lPower On and Of ˘¿ ° d ONLN d≈| »ä À )\f ˇˇˇˇˇˇ ‘@ (ÜÒ1
ˇˇ—Ú ˇÆ ( @ äIntroduction to the QuickT Ÿ$ )aake 100 Camera 4⁄ ä˙ (‡ äQuickT @ ) ake 100 Features
, (‡ 1-5 4 ^ H¿ ° d ONLN d \ ä h ¬ ( e ä LCD display è ° d ONLN d \ ¡ h Ò )7 , shown in ı ° d ONLN d \ Ò h )0Figur «¿ ° d ONLN d \ h )e 1-2 e@ ° d ONLN d \ hî ), becomes active, and the fl Ÿ ° d ONLN d < \î h )v ash is set to automatic. If the ° d ONLN d \ i ä u ì ( r ägr ‘ ° d ONLN d ^ i ì u
) een light is on in the view fi ο ° d ONLN d | i
u! )znder ◊¿ ° d ONLN d Ä i! uf ), the camera is r ° d ONLN d ë ig u¡ )Feady to take a pictur P¿ ° d ONLN d ¶ i¡ u )Ze.
ó H ® 4 ò H ® " ò H]
ˇ·ˇ‚7^
° d ONLN d ™ ç ä ò ¥ ( ï ä
Figure 1-1 ° d ONLN d µ ç Ã ò Ë )BQuickT @ ° d ONLN d ª ç Ë òÑ ) 'ake 100 lens cover in the open position
° d ONLN d ‰ ä! ê ( äT µ¿ ° d ONLN d  è! ‰ )o turn the power of <¿ ° d ONLN d ¯ Â!B )Vf, close the lens cover ° d ONLN dB!t )] . The pictur ≥ ° d ONLN dt! )2e r ¡† ° d ONLN d !¯ ) esolution, number of pictur ¡‡ ° d ONLN d9¯! )yes ° d ONLN d<" ä. (+ ätaken, and number of pictur |† ° d ONLN dW".i )|es available settings ar ä ° d ONLN do"i.Å )ce stor ç† ° d ONLN du"Å. ) ed after the power is turned of ·¿ ° d ONLN dî". )Üf. ° d ONLN dó/ ä; Œ (8 äOther settings r ° d ONLN dß/ œ;E )E eturn to the default values.
] Hn 4^ Hn "^ H]
ˇ·ˇ‚7^
° d ONLN dƒS ä^ ¥ ([ ä
Figure 1-2 ° d ONLN dœS Ã^ Ë )BQuickT @ ° d ONLN d’S Ë^† ) -ake 100 LCD display and user control buttons
H 4 H
ä
ˇ·ˇ‚7^
° d ONLN d˚ ä Õ ( ä Flash Button ˇˇˇˇˇˇ ‘@ (1
° d ONLN d ä ë ( äA ∫† ° d ONLN d ë ô ) fl G` ° d ONLN d ö ˙ ) ash button toggles thr Œ ° d ONLN d, ˙ )`ee fl Ó ° d ONLN d1 ~ )ash settings—automatic fl H` ° d ONLN dJô )sash, fl cÄ ° d ONLN dQô‘ )
ash on, and fl ≤† ° d ONLN d_‘Ó );ash of ‹¿ ° d ONLN deÓˆ )f.
5 H: 46 H: 7 ä7
ˇ·ˇ‚7^ ° d ONLN di* ä6 ◊ (3 äAutomatic Flash ˇˇˇˇˇˇ ‡ (31 ° d ONLN dz< äH ˆ (E äWhen power is on, the fl Õ† ° d ONLN dí< ˆHÆ )l)ash is set to automatic. When automatic fl ◊` ° d ONLN dº<ÆHÍ )∏ash is set, the ° d ONLN dÃI äU ™ (R äQuickT ÄÄ ° d ONLN d“I ™UU ) $ake 100 camera determines when the fl ˇ† ° d ONLN d˜IUUü )´ash is used accor ˜‡ ° d ONLN dIüU„ )Jding to the curr †¿ ° d ONLN dI‰U )E
ent light ° d ONLN d"V äb Ω (_ ä conditions. ãÄ ° d ONLN d.V Ωb ƒ )3A Δ ° d ONLN d/V ƒb – ) gr ö@ ° d ONLN d2V –b2 ) een light in the view fi E† ° d ONLN dJV3bä )cnder indicates the fl –@ ° d ONLN d_Väbÿ )Wash is fully power ú ° d ONLN dqVŸb
)O ed and the ° d ONLN d|c äo ∫ (l ä camera is r j‡ ° d ONLN dác ∫o )0eady to take a pictur õ† ° d ONLN dúco )Ze.
á ±ˇÅ Å Õ Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É òÅ˛ Ä ú˝ H H Ä≠ $µÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú˝Ô ~ { ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É ò @ @˝ @˝ ~K{ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ˝ `‡ 0>`à ˝ @H"À ˝ @Ä"à À ò @ @ Ä˝ @ Ä˝K ~ã{ ˝ ÄÄBà8gkBŒ ˝ ÄBpH⁄)çŒ ˝ D @íQŒ ˝ H@A,ñŒ ˝ 1Ä·‹˙Œ ˜ "à ˜ "à ˜ à ¡ ˝ ^ 6 à ˝ â 0à ˝ êÄ Ã
˛êêê @˝ ~K{ ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É (fi ˝ˇ ˇˇ¸ ˛ˇ¯ ˇˇ˝ ˇˇ˚ ¸ˇ ˇˇÅ Å Å ÷ )› ˇ¸ ˇ˚ ˇ¯ ˇ ˇ ˇ ˇ¸ ˇ˛ ˇÅ Å Å “ &› ˇ˝ ˇ˚ ˇ¯ ˇ˛ ˇ ˇ˛ ˇ¸ ˇÅ Å Å Œ òÅ˛ @ Ä˝ H H Ä≠ $∑Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
ˇ ˇˇ ˇ ˇ ˇ˛ ˇ ˛ˇˆ ˇ¸ ˇ¸ ˇ˚ ˇ˛ ˇˇ˝ ˇ ˇ ˇ ˇ˛ ˇ˛ ˇ¸ ˇ˛ ˇ ˛ˇ ˛ˇ˛ ˇ˛ ˇÅ Å ƒ Ä⁄ ˇ˛ ˇ˛ ˇ ˇ˚ ˇ ˇ ˇ˛ ˇ ˇ ˇˇ ˇˇ ˇ ˇ ˇ¸ ˇˇ ˇˇ ˇ ˇ ¸ˇÙ ˇ¸ ˇ¸ ˇ˙ ˇ ˇ ˇ˛ ˇ ˇ ˇˇ ˇˇ ˇ ˇ ˇ˝ ˇ ¸ˇ˝ ˇ˚ ˇ ˇÅ Å √ Üfi ˝ˇ ˇˇ¸ ˇˇ˚ ˇ ˇˇ˛ ˛ˇ ˝ˇ ˇ ˇ ˛ˇ˚ ˇ ˇ˛ ˛ˇ ˇ ˇˇ ˛ˇ˛ ˇ¸ ˛ˇ˛ ˛ˇ˛ ˛ˇ¸ ˇ ˇˇ˛ ˛ˇ ˝ˇ ˇ ˇ ˛ˇ˚ ˇ ˇˇ ˛ˇ ˛ˇ ˇ ˇˇÅ Å ¬ … ˇ ˇË ˇ— ˇÅ Å ø … ˇ∞ ˇ— ˇÅ Å ø ˛ˇ≤ ˛ˇ” ˛ˇÅ Å ¿ Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É ⁄ ˇÒ ˇÙ ˛ˇ ˇ“ ˛ˇÅ Å Å € ˇˇÚ ˇˇı ˇ˛ ˇ– ˇÅ Å Å ˇ "‹ ˇ ˇÚ ˇı ˇ˝ ˇÊ ˇÌ ˇÅ Å Å ˛ R‹ ˇ ˇ˛ ˝ˇ ˝ˇ ˇ˝ ˇ˚ ˇ˘ ˛ˇ ˇˇ ˇ ˇˇ ˝ˇ ˇˇ ˇ ˛ˇ˝ ˇ ˇˇ ˇ¯ ˇ ˝ˇ˛ ˇˇÅ Å â ^› ˇ ˇ˝ ˇ ˇ ˇ ˇ ˇ ˇˇ ˇ¸ ˇ˙ ˇ˛ ˇ ˇˇ ˇˇ ˇ ˇ ˇ ˇ ˇ ˇ˛ ˇˇ ˇ ˇˇ˜ ˇ˛ ˇ ˇ ˇ ˇÅ Å ä T› ¸ˇ ˇ˛ ˇ ˇ˛ ˇˇ˛ ˛ˇ˚ ˇ˚ ˇ˝
˛êêê @˝ß ~Á{ ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É òÅ˛ @ Ä˝ H H Ä≠ $∫Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ Ä˝Á ~'{ ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É òÅ˛ Ä ú˝ H H Ä≠ $ªÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú˝' ~C{ ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É ò @ @˝ @˝C ~É{ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ @ Ä˝ @ Ä˝É ~√{ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ Ä ú˝ Ä ú˝√ ~fl{ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ òÅ˛ @˝ H H Ä≠ $ºÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @˝C ~É{ ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É òÅ˛ @ Ä˝ H H Ä≠ $ΩÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ Ä˝É ~√{ ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É òÅ˛ Ä ú˝ H H Ä≠ $æÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú˝√ ~fl{ ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É ò @ @˝ @˝fl ~ { ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ @ Ä˝ @ Ä˝ ~_{ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ Ä ú˝ Ä ú˝_ ~{{ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ òÅ˛ @˝ H H Ä≠ $øÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @˝fl ~ { ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É òÅ˛ @ Ä˝ H H Ä≠ $¿Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ Ä˝ ~_{ ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É òÅ˛ Ä ú˝ H H Ä≠ $¡Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú˝_ ~{{ ' Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É Å Å Å É ˇ T @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER à )>1 , Helvetica
ˇˇ—Ú ˇÆ ( @ lIntroduction to the QuickT Ÿ$ )aake 100 Camera 4⁄ *˙¯
(‡ *1-6
)BQuickT @ ) ake 100 Features 4 ^ *¿¯
° d ONLN d \ l h Ü ( e lpictur È@ ° d ONLN d \ Ü h ¥ ) e is taken. Ê` ° d ONLN d \ ¥ h ª ).A ! ° d ONLN d \ º h » ) gr ı ° d ONLN d \ « h) ) een light in the view fi †Ä ° d ONLN d . \* hÅ )cnder indicates the fl + ° d ONLN d C \Ç h– )Xash is fully power ˜ ° d ONLN d U \– h )Ned and ° d ONLN d \ i l u ¨ ( r lthe camera is r »@ ° d ONLN d k i ¨ u )@eady to take a pictur ˘ ° d ONLN d Ä i u
)Ze.
è * î¯ 4 ê * î¯ ë l ë¯
ˇ·ˇ‚7^ ° d ONLN d É Ñ l ê ó ( ç l Flash Off ˇˇˇˇˇˇ ‡ ( çÚ1 ° d ONLN d é ñ l ¢ ã ( ü lIf the fl Ä ° d ONLN d ó ñ å ¢ — ) ash button is pr Ò¿ ° d ONLN d ß ñ – ¢ )D
ash. If the fl ; ° d ONLN dA £Ã Ø› )4ash ° d ONLN dE ∞ l º ü ( π l button is pr Δ‡ ° d ONLN dQ ∞ ü º € )3
essed while fl ø` ° d ONLN d_ ∞ € º ı )<ash of ÈÄ ° d ONLN de ∞ ı ºi ) f is active, the automatic-fl Y† ° d ONLN dÇ ∞j º„ )u ash setting becomes active.
⁄ * ·¯ 4 € * ·¯ ‹ l ‹¯
ˇ·ˇ‚7^
° d ONLN dü Õ l € ¬ ( ◊ lErase-All Button ˇˇˇˇˇˇ ‘@ ( ◊Ò1
° d ONLN d± · l Ì ù ( Í l
When the r é¿ ° d ONLN dª · ù Ì )1 ecessed erase-all button is pr ° d ONLN dŸ · Ìñ ) essed, all of the images curr A† ° d ONLN dˆ ·ñ Ìø )z
ently stor –` ° d ONLN d ·ø ÌÁ ))
ed in the ° d ONLN d
Ó l ˙ ó ( ˜ l camera ar ≈Ä ° d ONLN d Ó ó ˙ı )+Se erased. During the period of time that it takes for the images to be erased, the ° d ONLN df ˚ l ( l#erase-all icon on the LCD display fl ‚¿ ° d ONLN dä ˚$ )õashes. ô` ° d ONLN dë ˚$x ) After the images ar '† ° d ONLN d§ ˚y≤ )Ue erased, the ° d ONLN d≤ l Ü ( lpictur È@ ° d ONLN d∏ Üî )>es-available indicator displays the number of available pictur ı¿ ° d ONLN dˆî— (îes for the curr D¿ ° d ONLN d“‚ )>ent ° d ONLN d l! o ( lr E ° d ONLN d
p! ˙ ) esolution setting and the pictur *@ ° d ONLN d* ˙!É )ä es-taken indicator indicates zer O† ° d ONLN dJÉ!• )âo pictur Æ` ° d ONLN dR•!fl )"
es have been ° d ONLN d_" l. â (+ ltaken.
L *S¯ 4M *S¯ N lN¯
ˇ·ˇ‚7^
° d ONLN dg? lM s * T c@ ° d ONLN dh? sM ∞ ) imer Button ˇˇˇˇˇˇ ‘@ (IÒ1
° d ONLN duS l_ó (\ lDThe timer button allows you to initiate a 10-second time delay befor z ° d ONLN dπSó_¿ (\ó
e a pictur ≠ ° d ONLN d√S¿_Ó )) e is taken. ° d ONLN dœ` ll u (i lPr N† ° d ONLN d—` vlZ )
6essing the shutter button after the timer button is pr ° d ONLN d`[lÒ )Â"essed causes a 10-second count to ° d ONLN d)m ly ° (v l elapse befor ö` ° d ONLN d5m °y/ )5"e the shutter is actually opened. Ä ° d ONLN dWm/yÌ )é,An indicator light on the top of the camera ° d ONLN dÉz lÜ Ô (É l is on for 8 seconds and then fl Á` ° d ONLN d¢z ÔÜÒ )É<ashes rapidly for 2 seconds prior to the shutter opening to ° d ONLN dfiá lì ¨ (ê ltake the pictur a¿ ° d ONLN dÌá ¨ì´ )@;e. While the camera is in a timer sequence, no other featur √@ ° d ONLN d(á´ìŸ )ˇ es can be r °¿ ° d ONLN d3áŸìÔ ).eset. ° d ONLN d9î l† r (ù lY @Ä ° d ONLN d:î r† Ù ) ou can’t cancel a timed pictur 9† ° d ONLN dXî Ù†¬ )Ç/e sequence after the shutter button has been pr !Ä ° d ONLN dáî¬†Í )Œ essed by ° d ONLN dê° l≠ u (™ lpr G ° d ONLN dí° v≠ )
'essing the timer button a second time.
À *“¯ 4à *“¯ Õ lÕ¯
ˇ·ˇ‚7^
° d ONLN d∫æ là (» lResolution Button ˇˇˇˇˇˇ ‘@ (»Ò1
° d ONLN dÕ“ lfi É (€ lThe r Ä¿ ° d ONLN d““ Éfi3 )'esolution button toggles between high-r ˇ‡ ° d ONLN d˘“3fiì )∞esolution and standar ˚¿ ° d ONLN d“ìfi† )`d-r 0` ° d ONLN d“°fiÊ )esolution pictur ˆ‡ ° d ONLN d!“ÊfiÌ )Ee ° d ONLN d#fl lÎ (Ë l#modes. The maximum number of pictur ^¿ ° d ONLN dFfl Î≠ )±#es that can be taken is 8 in high-r Õ ° d ONLN difl≠ÎÙ )êesolution mode ° d ONLN dxÏ l¯ ∏ (ı land 32 in standar ÿ` ° d ONLN dâÏ ∏¯ ≈ )Ld-r
É Î )esolution setting also af s` ° d ONLN d# Î∏ )h-fects two indicators on the LCD display—the r ñ` ° d ONLN dP ∏„ )Õ
esolution ° d ONLN dZ l$ ø (! licon and the pictur ”@ ° d ONLN dm ø$ )Ses-available indicator y† ° d ONLN dÉ $= )^. The ef •@ ° d ONLN dã=$p )
fects that ar ÕÄ ° d ONLN dòp$‰ )3 e particular to the display ° d ONLN d¥% l1 ô (. l
during dif à¿ ° d ONLN dæ% ô1 • )-fer k@ ° d ONLN d¡% •1 π ) ent r ç† ° d ONLN dΔ% π1 )esolution settings ar A ° d ONLN d€%1Q )Ye described in ° d ONLN dÍ%R1ê )@ “LCD Display œ† ° d ONLN dˆ%è1ñ )=,” O† ° d ONLN d¯%ó1Ô ) later in this chapter ÆÄ ° d ONLN d%Ó1Û )W.
O *V¯ 4P *V¯ Q lQ¯
ˇ·ˇ‚7^
° d ONLN dB lP ∏ (L lShutter Button ˇˇˇˇˇˇ ‘@ (LÒ1
° d ONLN d!V lb ◊ (_ lThe shutter button contr + ° d ONLN d9V ÿb$ )lols when a pictur r† ° d ONLN dJV$b¡ )L'e is taken. If the shutter button is pr {@ ° d ONLN dqV¡bÔ )ù
essed and ° d ONLN d{c lo ˙ (l l the timer button has not been pr Ω¿ ° d ONLN dõc ˙o+ )é eviously pr é@ ° d ONLN d¶c,ok )2essed, a pictur †Ä ° d ONLN dµckoŒ )?e is taken immediately A‡ ° d ONLN dÀcŒoÏ )c . If the ° d ONLN d‘p l| Ÿ (y ltimer button has been pr W ° d ONLN dÏp Ÿ|¨ )m1essed, a 10-second delay occurs prior to a pictur }Ä ° d ONLN d p¨|Î )”e being taken. ° d ONLN d ,} lâ ´ (Ü l
When a pictur U† ° d ONLN d 9} ´â )?e is taken, the pictur w¿ ° d ONLN d O}âø )Y*es-taken indicator on the LCD display incr ’` ° d ONLN d y}øâÓ )ª
ements by ° d ONLN d Éä lñ) (ì l+1. The shutter button is disabled when ther @ ° d ONLN d Æä*ñ: )æe ar ‡ ° d ONLN d ≤ä:ñO )e zer ı ° d ONLN d ∑äNñp )o pictur S‡ ° d ONLN d øäqñ» )#es available in both ° d ONLN d ‘ó l£ á († lhigh-r ≥ ° d ONLN d ⁄ó ᣠÁ )esolution and standar Ø ° d ONLN d Ôó Á£ Ù )`d-r „† ° d ONLN d Úó Ù£9 )
esolution pictur ™ ° d ONLN d
ó:£c )F e modes. ˇ‡î @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER à )>1 , Helvetica
ˇˇ—Ú ˇÆ ( @ äIntroduction to the QuickT Ÿ$ )aake 100 Camera 4⁄ ä˙ (‡ äQuickT @ ) ake 100 Features
, (‡ 1-7 4 ^ H¿
k H r 4 l H r m ä m
ˇ·ˇ‚7^
ˇˇ‹. ˇ◊ ° d ONLN d \ ä k ÷ ( g ä LCD Display ˇˇˇˇˇˇ €r ( g1
° d ONLN d
r ä ~ æ ( { ä
The QuickT º@ ° d ONLN d r Ω ~¸ )3Iake 100 has an LCD display on the back of the camera to the right of the ° d ONLN d ` ä ã • ( à äviewfi < ° d ONLN d f ¶ ã ∫ ) nder ( ° d ONLN d j ∫ ã ˆ ), as shown in K ° d ONLN d x ˆ ã )<Figur ¿ ° d ONLN d } ã" )e 1-3 ª@ ° d ONLN d Ç " ã' ).
≠ H æ 4 Æ H æ " Æ H]
ˇ·ˇ‚7^
° d ONLN d Ö £ ä Æ ¥ ( ´ ä
Figure 1-3 ° d ONLN d ê £ Ã Æ, )BRear view of the QuickT ÇÄ ° d ONLN d ß £+ Æk )_ake 100 camera
° d ONLN d ∑; äG · (D äThe LCD display pr -† ° d ONLN d …; ‚GÒ )X<ovides information about the battery-power level, number of ° d ONLN dH äT § (Q äpictur È@ ° d ONLN d H §T )es taken, number of pictur ˇ` ° d ONLN d%HTu )tes still available, curr ° d ONLN d=HvT† )^
ent pictur ‰¿ ° d ONLN dGH†T¨ )*e-r «@ ° d ONLN dJH¨Tı ) esolution mode, ° d ONLN dZU äa ú (^ äcurr Ø ° d ONLN d^U úa ≤ )ent fl ° d ONLN ddU ≥aá )3ash setting, timer setting, and an erase-all pictur @ ° d ONLN dóUáa∫ )‘ es indicator º ° d ONLN d£Uπa
)2. Icons or numbers ° d ONLN d∂b än ’ (k äon the display pr ¶ ° d ONLN d«b ’n )Kovide a visual r è¿ ° d ONLN d◊bn' )Depr Ä ° d ONLN d⁄b(n )1esentation for each of these conditions. The LCD ° d ONLN d o ä{. (x ä$display is activated when the QuickT Í` ° d ONLN d/o-{å )£ake 100 camera is on.
∏ç ).2es-taken indicator is in the middle of the display l¿ ° d ONLN dh
å⁄ )‘. The count is incr ΩÄ ° d ONLN d{
⁄ )Nemented ° d ONLN dÉ ä# ÿ ( äeach time a pictur <‡ ° d ONLN dï Ÿ#0 )Oe is taken starting fr ÆÄ ° d ONLN d´0#Ø )W om 0 to the number of pictur ∞@ ° d ONLN d«Ø#◊ )
The pictur % ° d ONLN d˙H ∏Tú ).4es-available indicator displays the number of pictur ‡ ° d ONLN d.HúTø )‰ es that r "† ° d ONLN d7HøT )#emain to be taken ° d ONLN dIU äa ∑ (^ ä in the curr F ° d ONLN dTU ∏a ‚ ).
ent pictur ¿ ° d ONLN d^U „a Ô )+e-r Ô@ ° d ONLN daU Óa{ ) esolution mode. This value decr ‡ ° d ONLN dÄU|a• )é ements fr ]¿ ° d ONLN dâU•a„ ))om 8 in high-r ° d ONLN dóU‰a )?
esolution ° d ONLN d°b än à (k ä
mode and decr ∂† ° d ONLN dÆb Ãn ı )B ements fr Ä ° d ONLN d∑b ˆn? )*om 32 in standar º@ ° d ONLN d«b?nL )Id-r ‡ ° d ONLN d bLn√ )
esolution mode. The pictur " ° d ONLN d‰bƒn˙ )x
es-available ° d ONLN dÒo ä{ (x ä"indicator is located next to the r ‘ ° d ONLN do{´ )ã!esolution icon on the LCD display Ñ ° d ONLN d4o´{∞ )ñ. ° d ONLN d7Å äç ß (ä äIf the r ‘¿ ° d ONLN d?Å ßç ) esolution button is pr x‡ ° d ONLN dUÅçm )_essed when the QuickT √ ° d ONLN djÅlç◊ )fake 100 camera is in the ° d ONLN dÉé äö ´ (ó ästandar ±Ä ° d ONLN däé ´ö ∏ )!d-r Ê ° d ONLN dçé ∏ö )
˛êêê @ į ˇ ä?Ç ' (˜ ˛ˇ˘ ˘ˇ„ ˚ˇ ˚ˇ¥ ˘ˇ¸ ˛ˇ¯ ˇˇÌ ˇˇÅ Å œ ı ¸ˇˆ áˇ˜ ˛ˇ˜ ˇˇÌ ˇˇÅ Å Œ Ò ¸ˇÅ ˙ ¸ˇˆ ˇˇÌ ˇˇÅ Å Õ Ô ˜ˇà ˘ˇÛ ˇˇÌ ˇˇÅ Å Ã Ó ˇˇ˚ ÜˇÌ ˇˇÌ ˇˇÅ Å À Ì ˇˇÅ Ó ˇˇÌ ˇˇÅ Å Ï ˇˇÅ ˇˇÌ ˇˇÅ Å … Î ˇˇÅ Û ˛ˇÓ ˛ˇÅ Å » Í ˇˇÅ ˆ ˛ˇÓ ˛ˇÅ Å Δ È ˇÅ ˜ ˇˇÓ ˛ˇÅ Å ƒ È ˛ˇÅ ˚ ˛ˇÔ ˛ˇÅ Å ¬ Á ˇˇÅ ˝ ˇˇÓ ˇˇÅ Å ¿ Ê ˛ˇÅ ˛ˇÒ ¸ˇÅ Å ø ‰ ˛ˇÑ ˇˇÛ ¸ˇÅ Å ª ‚ ˇˇá ˛ˇı ˝ˇÅ Å ∑ · ˛ˇç ¸ˇ˙ ˘ˇÅ Å ¥ fl ˇˇì ˚ˇ ˆˇÅ Å ≠ fi ˛ˇô ıˇÅ Å £
‹ ñˇÅ Å ô Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů Ä ú¯ H H Ä≠ $ƒÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú¯? ä[Ç ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â ò @ @¯ @¯[ äõÇ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ˛ à èáÃÀ ˛ Q@À ˛ B ˝ êB Ìh@Œ ˝ †D E1†Œ ˝ £ hàJ!¿Œ
˛êêê @¯[ äõÇ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â '„ ˝ˇ ˇˇ¸ ˛ˇ¯ ˇˇ˛ ¸ˇ˝ ¸ˇ ˇˇÅ Å Å ◊ )‚ ˇ¸ ˇ˚ ˇ¯ ˇ ˇ ˇ˛ ˇ¸ ˇ˛ ˇÅ Å Å ” $‚ ˇ˝ ˇ˚ ˇ¯ ˇ˛ ˇ˝ ˇ˚ ˇÅ Å Å œ ;· ˇ ˇ˙ ˇ˘ ˇ˝ ˇ˝ ˇ˚ ˛ˇ˝ ˇˇ ˛ˇ ˇˇ ˇ ˇˇ ˇ˝ ˇÅ Å Å Î @· ˇ ˇ˘ ˇ˘ ˇ˝ ˇ˛ ˇ˚ ˇ ˇ˛ ˇˇ ˇˇ ˇ˛ ˇ ˇ ˇˇ˛ ˇˇ ˇÅ Å Å Ï @· ˇ ˇ˛ ˇˇ ˇ˚ ˇˇ ˇ˛ ˇ˛ ˇ˙ ˇ˚ ˇ ˇ ˇ ˇ ˇ˛ ˇ˝ ˛ˇÅ Å Å Î ;· ˇˇ˘ ˇ˝ ˇ˝ ˇ ˇ˝ ˇ˙ ˇ¸ ˇ ˇ ˇˇ ˇ ˇ ˇˇ˝ ˇÅ Å Å Ë 1· ˇ˘ ˚ˇ˚ ˇˇ˝ ˇ˙ ˛ˇ˝ ˛ˇ ˛ˇ ¸ˇ ˇ¸ ˛ˇÅ Å Å Î ¥ ˇ˛ ˇÅ Å Å € ¥ ˇ˛ ˇÅ Å Å € ≥ ˛ˇÅ Å Å ⁄ Å Å Å â „ ˝ˇ ˇˇÊ ˇÛ ˇˇ‚ ˇÅ Å Å ˚ ‚ ˇ¸ ˇÁ ˇÒ ˇ„ ˇˇÅ Å Å ˚ ‚ ˇ˝ ˇÊ ˇÚ ˇ‚ ˇÅ Å Å ˙ òů @ į H H Ä≠ $ΔÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
ˇ ˇˇ ˇ ˇ ˇ˛ ˇ ˛ˇ˘ ˇ˛ ˇ˛ ˇ˙ ˇ˛ ˇˇ˝ ˇ ˇ ˇ ˇ˛ ˇ˛ ˇ¸ ˇ˛ ˇ ˛ˇ ˛ˇ˛ ˇ˛ ˇÅ Å ø Çfl ˇ˛ ˇ˛ ˇ ˇ˚ ˇ ˇ ˇ˛ ˇ ˇ ˇˇ ˇˇ ˇ ˇ ˇ¸ ˇˇ ˇˇ ˇ ˇ ¸ˇˆ ˇ ˇ˛ ˇ ˇ¸ ˇ ˇ ˇ˛ ˇ ˇ ˇˇ ˇˇ ˇ ˇ ˇ˝ ˇ ¸ˇ˝ ˇ˚ ˇ ˇÅ Å æ É„ ˝ˇ ˇˇ¸ ˇˇ˚ ˇ ˇˇ˛ ˛ˇ ˝ˇ ˇ ˇ ˛ˇ˚ ˇ ˇ˛ ˛ˇ ˇ ˇˇ ˛ˇ˛ ˇ¸ ˇˇ˛ ˝ˇ¸ ˇ ˇˇ˛ ˛ˇ ˝ˇ ˇ ˇ ˛ˇ˚ ˇ ˇˇ ˛ˇ ˛ˇ ˇ ˇˇÅ Å Ω Œ ˇ ˇÓ ˇ— ˇÅ Å ∫ Œ ˇ∂ ˇ— ˇÅ Å ∫ œ ˛ˇ∏ ˛ˇ” ˛ˇÅ Å ª Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â fl ˇÒ ˇÙ ˛ˇ ˇ“ ˛ˇÅ Å Å ‡ ˇˇÚ ˇˇı ˇ˛ ˇ– ˇÅ Å Å "· ˇ ˇÚ ˇı ˇ˝ ˇÊ ˇÌ ˇÅ Å Å ˇ R· ˇ ˇ˛ ˝ˇ ˝ˇ ˇ˝ ˇ˚ ˇ˘ ˛ˇ ˇˇ ˇ ˇˇ ˝ˇ ˇˇ ˇ ˛ˇ˝ ˇ ˇˇ ˇ¯ ˇ ˝ˇ˛ ˇˇÅ Å ä ^‚ ˇ ˇ˝ ˇ ˇ ˇ ˇ ˇ ˇˇ ˇ¸ ˇ˙ ˇ˛ ˇ ˇˇ ˇˇ ˇ ˇ ˇ ˇ ˇ ˇ˛ ˇˇ ˇ ˇˇ˜ ˇ˛ ˇ ˇ ˇ ˇÅ Å ã T‚ ¸ˇ ˇ˛ ˇ ˇ˛ ˇˇ˛ ˛ˇ˚ ˇ˚ ˇ˝
ˇ ˇ ˇ ˇ ˇ˛ ˇ ˇ ˇ˛ ˇ˛ ˛ˇ ˇ˜ ˇ˛ ˇ ˇ ˇÅ Å á ]„ ˇ˝ ˇ ˇ ˇ ˇ ˇ ˇˇ ˇ¯ ˇ˛ ˇˇ ˇ˛ ˇ ˇ ˇ ˇˇ ˇ ˇ ˇ ˇ ˇˇ˛ ˇ˝ ˇˆ ˇ˛ ˇ ˇˇ ˇ ˇˇÅ Å ã \‰ ˇˇ ¸ˇ ˇˇ ˇ ˇˇ ˇ˛ ˛ˇ˙ ˛ˇ˝ ˛ˇ ˇ ˇ ˇ ˇ ˇˇ ¸ˇ ˇ˝ ˛ˇ ˇ¸ ˇ˝ ˛ˇ ˇ ˇ˛ ˇˇ˛ ˇÅ Å ç ‹ ˇ¸ ˇ⁄ ˇÁ ˇÅ Å Å ¯ ‹ ˇ¸ ˇ⁄ ˇÅ Å Å › › ˛ˇ˛ ˛ˇ‹ ˛ˇÅ Å Å fi Å Å Å â · ˝ˇ ˇˇÛ ˛ˇ ˛ˇÅ Å Å ’ ‚ ˇ˛ ˇÔ ˇÚ ˇ ˇÅ Å Å ” ‚ ˇ˛ ˇ ˇÚ ˇ ˇÅ Å Å “ 8· ˇ¸ ˇˇ ˇ ˝ˇ˝ ˇ ˇ˛ ˇ˝ ˇ˚ ˛ˇ¸ ˇˇ ˛ˇ ˇ ˇˇ ˇÅ Å Å „ @‡ ˇ˛ ˇ ˇ˛ ˇ ˇ ˇˇ ˇ ˇˇ ˇ ˇˇ ˇ¸ ˇ ˇ˝ ˇ ˇ ˇˇ˛ ˇˇÅ Å Å ‚ @„ ˇ˛ ˇ ˇ˛ ˇ ˇ ˇ ˇ˛ ˇ ˛ˇ ˛ˇ˚ ˇ ˇ˛ ˇ˛ ˇ ˇ˝ ˇÅ Å Å · 8„ ˇ˛ ˇ ˇ ˛ˇ ˇ ˇˇ ˇ ¸ˇ˝ ˇ˘ ˇ˛ ˇ ˇ ˝ˇ˝ ˇÅ Å Å ‡ òů Ä ú¯ H H Ä≠ $«Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú¯€ ä˜Ç ' @‰ ˇ ˛ˇ˛ ˇˇ ˇ ˇ ˇ˛ ˇ ˇˇ ˛ˇ ˛ˇ˝ ˛ˇ ˛ˇ ˇˇ ˇ ˇ˝ ˇÅ Å Å ‡ Å Å Å â Å Å Å â Å Å Å â Å Å Å â · ˛ˇ ˇ ˇ‘ ˇˇ˚ ˇˇÅ Å Å Ë ‡ ˇ ˇˇ ˇˇ’ ˇ ˇ˝ ˇ ˇÅ Å Å È "· ˇ ˇ ˇÙ ˇÙ ˇÓ ˇ˘ ˇÅ Å Å È ;· ˇ ˇ ˇ ˇˇ ˇ˛ ˘ˇ ˇ˛ ˇˇ ˝ˇ ˛ˇ ˇˇ ˇ˚ ˇˇ¯ ˇÅ Å Å È @· ˇ ˇ ˇ˛ ˇ ˇ ˇ ˇ ˇ ˇˇ˛ ˇ ˇ ˇ ˇ˛ ˇ ˇˇ¯ ˇ˙ ˇÅ Å Å Ë >‚ ˇ ˇ ˇ˛ ˇ ˇ˝ ˇ˛ ˇ ˇ˛ ˇ˛ ˇ ˇ ˇ˝ ˇ ˇ˜ ˇ˚ ˇÅ Å Å Á @‚ ˇ ˇˇ ˇˇ ˇ ˇ ˇˇ ˇ ˇ ˇ˝ ˇ ˝ˇ ˇ˛ ˇ ˇˆ ˇ¸ ˇ ˇÅ Å Å È =„ ˛ˇ ˇ ˇ ¸ˇ ˛ˇ ˇ ˇ¸ ˇˇ ˇ ˇ˛ ˛ˇ ˇ˙ ˝ˇ˛ ˇ ˝ˇÅ Å Å Ë Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â ò @ @¯ @¯˜ ä7Ç ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ @ į @ į7 äwÇ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ Ä ú¯ Ä ú¯w äìÇ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ òů @¯ H H Ä≠ $»Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @¯˜ ä7Ç ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů @ į H H Ä≠ $…Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ į7 äwÇ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů Ä ú¯ H H Ä≠ $ Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú¯w äìÇ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â ò @ @¯ @¯ì ä”Ç ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ @ į @ į” äÇ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ Ä ú¯ Ä ú¯ ä/Ç ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ òů @¯ H H Ä≠ $ÀÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @¯ì ä”Ç ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů @ į H H Ä≠ $ÃÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ į” äÇ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů Ä ú¯ H H Ä≠ $ÕÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú¯ ä/Ç ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â ò @ @¯ @¯/ äoÇ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ @ į @ įo äØÇ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ Ä ú¯ Ä ú¯Ø äÀÇ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ òů @¯ H H Ä≠ $ŒÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @¯/ äoÇ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů @ į H H Ä≠ $œÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ įo äØÇ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů Ä ú¯ H H Ä≠ $–Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú¯Ø äÀÇ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â ˇ` @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER à )>1 , Helvetica
ˇˇ—Ú ˇÆ ( @ lIntroduction to the QuickT Ÿ$ )aake 100 Camera 4⁄ *˙¯
(‡ *1-8
)BQuickT @ ) ake 100 Features 4 ^ *¿¯
° d ONLN d \ l h º ( e lavailable in high-r Ä ° d ONLN d \ Ω hR )Q esolution mode. The number decr p` ° d ONLN d 2 \R h¨ )ïeases because high-r ° d ONLN d F \¨ h◊ )Z
esolution ° d ONLN d P i l u Ü ( r lpictur È@ ° d ONLN d V i Ü u « )es consume lar 6 ° d ONLN d d i » uä )B(ger amounts of image memory than standar ć ° d ONLN d å iä uó )¬d-r µÄ ° d ONLN d è ió u‹ )
esolution pictur | ° d ONLN d ü i› uÎ )Fes. ° d ONLN d § { l á â ( Ñ lIf the r ‘¿ ° d ONLN d ¨ { â á Á ) esolution button is pr x‡ ° d ONLN d ¬ { Ë áO )_essed while the QuickT ¬Ä ° d ONLN d ÿ {N áπ )fake 100 camera is in the ° d ONLN d Ò à l î á ( ë lhigh-r ≥ ° d ONLN d ˜ à á î ‰ )esolution mode, the r a† ° d ONLN d à  î~ )^!esolution mode changes to standar ˇ‡ ° d ONLN d- à~ îä )ôd r `† ° d ONLN d0 àã î⁄ )
esolution and the ° d ONLN dB ï l ° Ü ( û lpictur È@ ° d ONLN dH ï Ü °∞ )Ees-available indicator changes to indicate the total number of pictur ¿ ° d ONLN dç ï∞ ° ( û∞es available in ° d ONLN dù ¢ l Æ ù ( ´ l the standar ‡ ° d ONLN d® ¢ û Æ ´ )2d-r CÄ ° d ONLN d´ ¢ ´ Æ> )
esolution mode. The number incr j¿ ° d ONLN d ¢> Æû )ìeases because standar x¿ ° d ONLN dfl ¢û Æ´ )`d-r ≠` ° d ONLN d‚ ¢´ Æ÷ )
esolution ° d ONLN dÏ Ø l ª Ü ( ∏ lpictur È@ ° d ONLN dÚ Ø Ü ªä )6es consume smaller amounts of image memory than high-r '¿ ° d ONLN d( Øã ª– ( ∏ãesolution pictur Ó@ ° d ONLN d8 Ø– ªfi )Ees. ° d ONLN d= ¡ l Õ ó ( l If a pictur õ† ° d ONLN dH ¡ ó Õ )+e is taken when the pictur Å ° d ONLN db ¡ Õ )re r è¿ ° d ONLN de ¡ ÕÉ ) esolution setting is high r E‡ ° d ONLN dÄ ¡Ñ ÕÈ )pesolution and the total ° d ONLN dò Œ l ⁄ ∑ ( ◊ lnumber of pictur £ ° d ONLN d® Œ ∑ ⁄C )K!es available indicates one pictur K ° d ONLN d… ŒD ⁄x )ç
e, the pictur €` ° d ONLN d÷ Œx ⁄ÿ )4es-available indicator ° d ONLN dÌ € l Á ‡ ( ‰ ldisplays 0 for one second. ø` ° d ONLN d € ‡ Áf )t After one second elapses, the r ]@ ° d ONLN d' €g ÁÔ )á esolution setting is changed to ° d ONLN dG Ë l Ù ç ( Ò lstandar ±Ä ° d ONLN dN Ë ç Ù ô )!d r @ ° d ONLN dQ Ë ö Ù ˛ )
esolution and the appr @ ° d ONLN dg Ë ˛ Ùk )dopriate number of pictur ‡ ° d ONLN d Ëk Ù— )mes available for standar )† ° d ONLN dó Ë— ÙŸ )fd ° d ONLN dô ı l o ( ˛ lr E ° d ONLN dö ı p ) esolution is indicated. If the r Ú@ ° d ONLN d∫ ı N )Äesolution button is pr ñ` ° d ONLN d– ıO∑ )_essed at this point, the r Q ° d ONLN dÍ ı∏„ )i
esolution ° d ONLN dÙ l Œ ( lchanges back to high r F‡ ° d ONLN d
œi )c"esolution and the number of pictur ë† ° d ONLN d,iÊ )ö es available changes to 0 for ° d ONLN dJ l ¢ ( l one second. ㆠ° d ONLN dV ¢( )6 After one second elapses, the r )Ä ° d ONLN du)ÿ )á'esolution once again changes to standar ‚Ä ° d ONLN dúÿÙ )Ød and ° d ONLN d¢ l( ë (% lthe appr ¶† ° d ONLN d™ ë( ˛ )%opriate number of pictur ®@ ° d ONLN d¬ ˛(p )mes available in the standar ( ° d ONLN d› q(~ )sd-r \¿ ° d ONLN d‡ ~(Œ )
esolution mode is ° d ONLN dÚ) l5 ú (2 l displayed. ˇ¯ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4⁄ ∫˙ , Palatino
3, . Ã +∫#CHAPTER ÿ )h2
ˇˇu÷ ˇÆ ° d ONLN d Z ∫ w ( p ∫QuickT ±Ñ ° d ONLN d Z
wπ )Sake 100 Driver
ô H8 4 ô H8 2 H2
ˇ·ˇ‚7^ ° d ONLN d z ∫ ó ( ê ∫Softwar ¢* ° d ONLN d z ó )Ye ˇˇˇˇˇˇ ä* )ˆ2
° d ONLN d \ l h Ø ( e lThis chapter pr ° ° d ONLN d \ Ø h ‚ )C esents an ar X` ° d ONLN d \ „ h| )4"chitectural overview of the QuickT Q† ° d ONLN d = \| hfi )ôake 100 driver softwar Ë` ° d ONLN d S \fi hÁ )be, ° d ONLN d V i l u u ( r lpr G ° d ONLN d X i v u ¯ )
ovides basic guidelines for pr ¿ ° d ONLN d v i ¯ uâ )Ç ogramming applications to contr Ì ° d ONLN d ï ià uƒ )ê
ol the QuickT (‡ ° d ONLN d ¢ iƒ uÁ )<ake 100 ° d ONLN d ™ v l Ç • ( l camera and r 2† ° d ONLN d ∂ v ¶ Ç ˘ ):etrieve images stor _ ° d ONLN d … v ˘ Çi )Sed in the camera memory )@ ° d ONLN d ‡ vi Çı )p", describes the driver functions, ° d ONLN d É l èÙ ( å lXand includes a sample code listing that shows how you could use the driver functions in ° d ONLN dZ ê l ú Á *
a Macintosh application to r @ ° d ONLN dv ê Ë ú: )|etrieve an image fr π ° d ONLN dâ ê: ú| )R
om the QuickT ‡Ä ° d ONLN dñ ê{ ú√ )Aake 100 camera.
The QuickT º@ ° d ONLN dÿ fl ü ΢ )3=ake 100 device driver includes a library of functions that ar TÄ ° d ONLN d fl£ · ( Ë£e designed to ° d ONLN d# Ï l ¯ ´ ( ı lfacilitate contr ä ° d ONLN d3 Ï ´ ¯ Ú )?ol of the QuickT @ ° d ONLN dC Ï Ú ¯Ä )G ake 100 camera for taking pictur ( ° d ONLN dc ÏÄ ¯¢ )ées and r ‡‡ ° d ONLN dk Ï¢ ¯Ê )"etrieving pictur i‡ ° d ONLN d{ ÏÁ ¯Ó )Ee ° d ONLN d} ˘ l û ( l images stor ° d ONLN dà ˘ ü Ë )3ed in the QuickT ° d ONLN dò ˘ Ë• )I,ake 100 camera. This library of functions ef K ° d ONLN dƒ ˘•˜ )Ωfectively hides the ° d ONLN dÿ l ® ( l
device-specifi Ô‡ ° d ONLN dÊ ® Î )<c details that ar 0¿ ° d ONLN d˜ Ï% )D
e otherwise r J‡ ° d ONLN d%< )9equir b ° d ONLN d <˜ )+ed to enable an application to perform the ° d ONLN d4 l á ( ltasks. ° d ONLN d<% l1j *;The functions in the library can be categorized as follows: ,
Zapf Dingbats
° d ONLN dx; lB q *n
° d ONLN dz8 xDÏ ) XDriver initialization functions. The functions in this category allocate and deallocate ° d ONLN d“D xP ô * data str º ° d ONLN d⁄D ôP ∞ )!uctur B ° d ONLN dflD ±P )es used by the QuickT f¿ ° d ONLN dÙDPo )aake 100 device driver â@ ° d ONLN d DoPq )].
° d ONLN d Y l` q (_ ln
° d ONLN d
V xbå ) >Camera connection functions. The functions in this category ar Ë ° d ONLN dKVåbÓ (_åe used to identify and ° d ONLN dbb xn — (k xconnect to a camera.
All QuickT òÄ ° d ONLN dÈ ú )0ake 100 driver functions r Z¿ ° d ONLN d
2 )q eturn a r ˆ‡ ° d ONLN d 2ÿ )%)esult code to notify the caller that the ° d ONLN d5 l . ( l,function has successfully completed or to pr <Ä ° d ONLN da/ U )√ ovide a r Î ° d ONLN djU à )& eason if the function is not ° d ONLN dá l+ ù (( l successful. Õ@ ° d ONLN dì ù+ § )1A ‡ ° d ONLN dî •+ ´ ) r L‡ ° d ONLN dñ ´+ ˝ )esult code of 0 (zer ¸` ° d ONLN d™ ˝+π )R+o) always indicates successful completion. ° d ONLN d÷1 l= ® (: l
Courier R` ° d ONLN d ]ûiÚ )QCmGetErrorInfo R` ° d ONLN d ]ÚiÙ )T . ° d ONLN d j lv (s l#function. For information about err à¿ ° d ONLN d Bjv¢ )õ$ors detected by the camera, see the . ° d ONLN d fw lÉ ¿ (Ä lCmGetErrorInfo ° d ONLN d tw ¿É! )T function described on ° d ONLN d ãw!É9 )apage ° d ONLN d êw9ÉL )2-48 ° d ONLN d îwLÉQ ). ˇ @ ˇ ˇˇˇˇ @
ˇˇ‹. ˇ◊ ° d ONLN d& ä$ ( äInitializing the QuickT ΩÇ ° d ONLN d=
$ê )Äake 100 Device Driver ˇˇˇˇˇˇ €r ( 2
° d ONLN dT+ ä7 ê (4 äY @Ä ° d ONLN dU+ ê7 ı )our application must fi M‡ ° d ONLN dl+ ı7] )erst initialize the QuickT Ö ° d ONLN dÖ+\7 )g*ake 100 device driver by making a call to ˇˇJ . ° d ONLN dØ8 äD õ (A äthe ,
Courier ˇ˝fi áJ ° d ONLN d≥8 õD „ ) CmOpenDriver ˇˇJ áJ ° d ONLN dø8 „D )H function. ˇ˝fi ïfi ° d ONLN d 8 DT )) CmOpenDriver ˇˇJ ïfi ° d ONLN d÷8TDˆ )H' allocates and initializes internal str ¶P ° d ONLN d˝8ˆD )¢uctur x∞ ° d ONLN d8 D )es . ° d ONLN dE äQ ç (N är E ° d ONLN dE éQ • )equir \@ ° d ONLN d E •Q† )9ed by the driver to successfully perform any operations r @` ° d ONLN dDE†Q )˚equested by subsequent ° d ONLN d[R ä^ ¢ ([ äcalls. . ° d ONLN dcd äp *On the Macintosh platform, ° d ONLN d~d pS )Å CmOpenDriver ° d ONLN dädSp˛ )H& also initializes and opens the QuickT ï ° d ONLN d∞d˝p )™ake ° d ONLN d¥q ä} ∏ (z ä
100 driver ¬† ° d ONLN dæq ∑} – )-. The ¬† ° d ONLN dƒq –} ) CmOpenDriver ¬† ° d ONLN d–q}É )H function is described on ¬† ° d ONLN dÍqÉ}õ )kpage ¬† ° d ONLN dÔqõ}Æ )2-20 ¬† ° d ONLN dÛqÆ}≥ ).
)Q olled befor S` ° d ONLN dï∂ ¬ )0>e making a connection to it. This is performed by calling the . ° d ONLN d”√ äœ ÿ (à ä
CmGetPortInfo ° d ONLN d‡√ ÿœ )NF function to determine whether a camera is attached to the host. If a ° d ONLN d&– ä‹D (Ÿ ä*camera is attached to the host, then call ° d ONLN dP–D‹z )∫ CmConnect ° d ONLN dY–z‹
)6 to make a connection with that . ° d ONLN dy› äÈ Ø (Ê äcamera. . ° d ONLN dÇÔ ä˚ û *The ° d ONLN dÜÔ û˚ Ï )
CmGetPortInfo ° d ONLN dìÔ Ï˚ )N function r R` ° d ONLN dûÔ˚= ), eturns a R` ° d ONLN dßÔ=˚y )%
CmPortInfo R` ° d ONLN d±Ôy˚ü )< data str >` ° d ONLN d∫Ôü˚µ )&uctur ¿ ° d ONLN døÔµ˚˝ )e that contains, . ° d ONLN d–¸ ä[ ( ä.among other things, information about the curr óÄ ° d ONLN d˛¸[ )—(ent status and availability of a camera ° d ONLN d& ä Í ( äattached to the specifi Ø ° d ONLN d= Í) )`ed serial port. ° d ONLN dN ä'
($ äZAfter you determine that a serial port has a camera attached to it and that the camera is . ° d ONLN d®( ä4 *
available, you then call the ° d ONLN d≈( 4B )Ç CmConnect ° d ONLN dŒ(B4À )6 function with a handle to the ° d ONLN dÌ(À4 )â
CmPortInfo ° d ONLN d˜(4 )< . ° d ONLN d¯5 äA ï (> ästr fi ° d ONLN d˚5 ïA ¨ ) uctur c‡ ° d ONLN d 5 ≠A )e for the camera. If mor à@ ° d ONLN d5AŸ )g,e than one camera is attached, you should pr ˚ ° d ONLN dD5ŸA˚ )≈ovide a ° d ONLN dLB äN (K äQdialog box that asks the user which camera he or she would like to connect with. . ° d ONLN dûT ä` û *The ° d ONLN d¢T û` ‘ ) CmConnect ° d ONLN d´T ‘`” )69 function establishes a connection with the camera specif PÄ ° d ONLN d‰T”`Ô )ˇied in ° d ONLN dÎa äm Δ (j ä
CmPortInfo ° d ONLN dıa Δm À )<. ° d ONLN d˜a Àm ) CmConnect ° d ONLN d am )6 and ° d ONLN damR )
CmPortInfo ° d ONLN daRm‹ )< should be called once for each . ° d ONLN d/n äz3 (w ä#communication session with a QuickT ¥ ° d ONLN dRn2z )®,ake 100 camera. See the descriptions of the . ° d ONLN d~{ äá ÿ (Ñ ä
CmGetPortInfo ° d ONLN dã{ ÿá )N
function on ° d ONLN dò{ á$ )4page ° d ONLN dù{$á7 )2-22 ° d ONLN d°{7áN ), the ° d ONLN dß{NáÑ ) CmConnect ° d ONLN d∞{Ñá∏ )6
function on ° d ONLN dΩ{∏á– )4page ° d ONLN d¬{–á„ )2-25 ° d ONLN dΔ{„á
)
, and the ° d ONLN d–à äî “ (ë ä CmDisconnect ° d ONLN d‹à “î )H
function on ° d ONLN dÈàî )4page ° d ONLN dÓà î1 )2-27 ° d ONLN dÚà1î )2 for additional information about connecting to a ° d ONLN d$ï ä° ´ (û äQuickT ï ° d ONLN d*ï ™°X ) 'ake 100 camera. See the description of ï ° d ONLN dQïX°î )Æ
CmPortInfo ï ° d ONLN d[ïî°¢ )< on ï ° d ONLN d_∫ )page ï ° d ONLN ddï∫°Õ )2-10 ï ° d ONLN dhïÕ°“ ). ˇ ® @ ˇ ˇˇˇˇ @
° d ONLN d ^ l f ã ( d lIMPORT Ä ° d ONLN d ^ ã f õ ) ANT
ˇ·ˇ‚7^
. ° d ONLN d i l u
( r l!Although an application may call ,
Courier ° d ONLN d 5 i
uX )û
CmGetPortInfo ° d ONLN d B iX u´ )N successively on as . ° d ONLN d V u l Å ÿ ( ~ lmany serial ports as ther GÄ ° d ONLN d o u Ÿ Å È )me ar V ° d ONLN d s u È Åx ) e available on the host computer ? ° d ONLN d ì ux Å´ )è
, the driver ° d ONLN d † Å l ç ( ä l!can interact with only one QuickT œ ° d ONLN d ¡ Å ço )ïake 100 camera at a time. ,
Zapf Dingbats
3 ° d ONLN d € Ñu å| )ts
± * ∏¯ 4 ≤ * ∏¯ ≥ l ≥¯
ˇ·ˇ‚7^
ˇˇ‹. ˇ◊ ° d ONLN d › ¢ l ±4 ( ≠ l Capturing and Retrieving Images ˇˇˇˇˇˇ €r ( ≠2
° d ONLN d ˛ ∏ l ƒØ ( ¡ lJAfter the driver is initialized and the connection is made with the QuickT á ° d ONLN dH ∏Ø ƒ˜ ( ¡Øake 100 camera, ° d ONLN dX ≈ l —™ ( Œ lIthe application can interact with camera to perform the following tasks:
° d ONLN d¢ € l ‚ q *n
. ° d ONLN d§ ÿ x ‰ ≠ ) Get the curr R` ° d ONLN d∞ ÿ ≠ ‰[ )5(ent status of the camera by calling the R` ° d ONLN dÿ ÿ[ ‰µ )ÆCmGetCameraInfo R` ° d ONLN dÁ ÿµ ‰Ù )Z function. The . ° d ONLN dˆ ‰ x œ ( Ì xstatus information r @ ° d ONLN d
‰ – ¿ )X6eturned by this function includes the number of pictur ] ° d ONLN d@ ‰¿ ˜ )
es that have ° d ONLN dM x ¸ ( ˘ x been taken, the number of pictur Ÿ ° d ONLN dm ¸ˆ )ê8es that can be taken, camera battery status, and so on. . ° d ONLN d• ¸ x ( x Refer to the description of the ° d ONLN d≈ ¸\ )äCmGetCameraInfo ° d ONLN d‘ ¸\ê )Z
function on ° d ONLN d· ¸ê® )4page ° d ONLN dÊ ¸®ª )2-28 ° d ONLN dÍ ¸ª¿ ).
. ° d ONLN dÌ l q ( ln
° d ONLN dÔ x ≈ ) Get information r ≠Ä ° d ONLN d ≈º )M:elated to a particular image in the camera by calling the . ° d ONLN d: x& ÿ (# xCmGetPictureInfo ° d ONLN dJ ÿ&S )` function. The information r R` ° d ONLN dfS&¯ ){&eturned by this function includes the . ° d ONLN då& x2 (/ x!size, in bytes, of the image corr ·¿ ° d ONLN d≠& 2g )àesponding to the pictur Ä ° d ONLN dƒ&h2Ò )h e; the image width and height, ° d ONLN d„2 x> (; x'in pixels; the date and time the pictur = ° d ONLN d
2 >Ö )•e was taken; and so on.
° d ONLN d#G lN q (M ln
ˇˇã¢ . ° d ONLN d%D xP ˝ ) Retrieve the image by issuing ˇ˛¢Ê :* ° d ONLN dCD ˛Pp )ÜCmGetThumbnailImage ˇˇã¢ :* ° d ONLN dVDpP¯ )r (for the thumbnail version) or ° d ONLN dvP x\ ‰ (Y xCmGetFullSizeImage ° d ONLN dàP ‰\M )l (for either the standar R` ° d ONLN d†PM\[ )id-r $¿ ° d ONLN d£P[\∞ )esolution or high-r ˜ ° d ONLN d∂PØ\⁄ )T
esolution . ° d ONLN d¿\ xh û (e x version). "† ° d ONLN d…\ üh ° )'
° d ONLN dÀq lx q (w ln
. ° d ONLN dÕn xz ò ) Captur R` ° d ONLN d”n òz ˘ ) e an image by calling R` ° d ONLN dÈn ˘zG )a
CmTakePicture R` ° d ONLN dˆnGzâ )N, optionally pr $¿ ° d ONLN dnâz )Beceded by calls to such ° d ONLN d z xÜ Æ (É x
§| )CmGetThumbnailImage ° d ONLN d·ò|§ä )r on ° d ONLN dÂò䧢 )page ° d ONLN dÍò¢§µ )2-54 ° d ONLN dÓòµ§∫ ), ° d ONLN d• l± ÿ (Æ lCmGetFullSizeImage ° d ONLN d• ÿ± Ê )l on ° d ONLN d• ʱ ˛ )page ° d ONLN d • ˛± )2-57 ° d ONLN d•± ), ° d ONLN d•±j )CmSetFlashMode ° d ONLN d •j±x )T on ° d ONLN d#•x±ê )page ° d ONLN d(•ê±£ )2-42 ° d ONLN d,•£±® ), ° d ONLN d.≤ læ à (ª lCmSetPictureMode ° d ONLN d>≤ Ãæ ⁄ )` on ° d ONLN dB≤ ⁄æ Ú )page ° d ONLN dG≤ Úæ )2-41 ° d ONLN dK≤æ ), and ° d ONLN dQ≤ æG )CmErase ° d ONLN dX≤GæU )* on ° d ONLN d\≤Uæm )page ° d ONLN da≤mæÄ )2-31 ° d ONLN de≤ÄæÖ ).
„ *ͯ 4‰ *ͯ  l¯
ˇ·ˇ‚7^
ˇˇ‹. . ˇ◊ ° d ONLN dh‘ l„. (fl l Closing the Camera Connection ˇˇˇˇˇˇ €r (fl2
° d ONLN dáÔ l˚ Ë (¯ l After your application has fi j ° d ONLN d§Ô È˚ƒ )}2nished interacting with the camera, it must declar Ñ¿ ° d ONLN d÷Ôƒ˚ÿ )€e its . ° d ONLN d‹¸ ld ( l8intention to end the session with the camera by calling ° d ONLN d¸d¨ )¯ CmDisconnect ° d ONLN d ¸¨¡ )H and ˇ˛™® ° d ONLN d% l “ ( lCmDisposePortInfo ˇˇé8 ° d ONLN d6 “ )f . Since the ˇ˛™® *® ° d ONLN dB 8 )0 CmConnect ˇˇé8 *® ° d ONLN dK 8¯ )6- function establishes an implicit connection . ° d ONLN dx l"À ( lMwith a camera within which the driver functions work, your application must fi üÄ ° d ONLN dΔÀ"Ï ( Àrst end ° d ONLN dŒ# l/ ë (, lany curr èÄ ° d ONLN d÷# ë/ Î )%ent connection befor ÄÄ ° d ONLN dÍ# Î/Ô )Z?e it is able to establish a connection and interact with other ° d ONLN d)0 l< Æ (9 lcameras, if any æÄ ° d ONLN d80 ≠<= )A , connected to the host computer ` ° d ONLN dX0=<B )ê. ° d ONLN d[B lN$ (K l*After your application has closed the curr Z@ ° d ONLN dÖB$N‡ )∏)ent camera connection, it may open a new ° d ONLN dÆO l[Ú (X lWconnection with the same camera or other cameras connected to the host as described in ° d ONLN d \ lh *
“Establishing a Connection W ò‡ ° d ONLN d !\ h9 )Ñith the Camera,” ô† ° d ONLN d 1\9hô )I earlier in this chapter Z¿ ° d ONLN d I\ôhû )`. . ° d ONLN d Ln lz é (w lFor mor R` ° d ONLN d Sn éz6 )"'e information, see the descriptions of R` ° d ONLN d zn6z~ )® CmDisconnect R` ° d ONLN d Ün~zå )H on R` ° d ONLN d änåz§ )page R` ° d ONLN d èn§z∑ )2-27 R` ° d ONLN d ìn∑zà ) and ° d ONLN d ò{ lá ¢ (Ñ l CmConnect ° d ONLN d °{ ¢á ∞ )6 on ° d ONLN d •{ ∞á » )page ° d ONLN d ™{ »á € )2-25 ° d ONLN d Æ{ €á ‡ ). ˇ@ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER à )>2 , Helvetica
ˇˇ—Ú ˇÆ ( @ äQuickT ÎÏ )ake 100 Driver Software 4⁄ ä˙ (‡ ä3Sample Code for Retrieving an Image From the Camera
° d ONLN d ) r ä ~ ( { ä After your application has fi j ° d ONLN d F r ~– )},nished whatever it had to do with the QuickT @Ä ° d ONLN d r r– ~ )…ake 100 device ° d ONLN d Å ä ã ˇ ( à ädriver and disconnected fr äÄ ° d ONLN d õ ˇ ã )u?om any camera with which it was interacting , it must call the . ° d ONLN d ⁄ å ä ò ∞ ( ï ä function ,
Courier ° d ONLN d „ å ∞ ò ˛ )&
CmCloseDriver ¬† ° d ONLN d å ˝ òG )M. This function fr ï ° d ONLN d åG òú )Jees the internal str Å ° d ONLN d åú ò≤ )Uuctur S` ° d ONLN d å≤ ò )es used by the driver ñ ° d ONLN d0 å ò )\. ° d ONLN d3 û ä ™ ( ß äOn the Macintosh platform, ° d ONLN dN û ™Y )Å
CmCloseDriver ° d ONLN d[ ûY ™… )N closes the camera driver ¬† ° d ONLN dt û» ™À )o. ° d ONLN dv ∞ ä º ¨ ( π äFor mor R` ° d ONLN d} ∞ ¨ ºP )"&e information, see the description of R` ° d ONLN d£ ∞P ºû )§
CmCloseDriver R` ° d ONLN d∞ ∞û º¨ )N on R` ° d ONLN d¥ ∞¨ ºƒ )page R` ° d ONLN dπ ∞ƒ º◊ )2-21 R` ° d ONLN dΩ ∞◊ º‹ ).
ˇˇƒb . ° d ONLN dˆ ˇ ä π ( ä Listing 2-1 Db ° d ONLN d ˇ ∫ : )0 , for the Macintosh computer òä ° d ONLN d ˇ9 ß ), shows a function called ˇˇM& nt ° d ONLN d7 ˇ® ÿ )oGetImage ˇˇƒb nt ° d ONLN d? ˇÿ )0 that uses the . ° d ONLN dN ä ™ ( äQuickT ÄÄ ° d ONLN dT ™E ) $ake 100 device driver functions to r ®Ä ° d ONLN dx Eó )õetrieve an image fr H` ° d ONLN dã ò⁄ )S
om the QuickT o¿ ° d ONLN dò Ÿ¸ )Aake 100 ° d ONLN d† ä% Ø (" äcamera.
. ° d ONLN d a äm (j ä#include "CmDriver.h" ° d ONLN d!y äÖ *#define kGenericErr -1 ° d ONLN d8ë äù
*@OSErr GetImage(unsigned short imageNumber, Handle *imageBuffer, ° d ONLN d{ü Æ´D +$unsigned long *imageSize) ° d ONLN dï≠ äπ ê (∂ ä{ ° d ONLN dòª ú« ÿ +
OSErr err; ° d ONLN d§… ú’ fi * CameraData ° d ONLN d±…’8 )lcamData; ° d ONLN dª◊ ú„ (‡ úCmPortInfoHandle ° d ONLN dŒ◊„b )lportInfoHandle; ° d ONLN dfl úÒ (Ó úunsigned long ° d ONLN dÔÂÒD )l
portIndex; ° d ONLN d˚Û úˇ (¸ úCmPictureInfo ° d ONLN d ÛˇV )l
*pictureInfo; ° d ONLN d ú
à (
úBoolean ° d ONLN d$
D )l
firstRead; ° d ONLN d0 ú ( úunsigned long ° d ONLN d@P )l actualBytes; ° d ONLN dM' ä3¯ (0 ä=/* Open the QuickTake 100 camera driver with CmOpenDriver. */ ° d ONLN då5 úAJ + err = CmOpenDriver(&camData); ° d ONLN d¨C ÆOÜ +$if (err != noErr || camData == NULL) ° d ONLN d”Q Æ] ¥ * ° d ONLN d’Q ¿] ) return err; ° d ONLN d·i äu ú (r ä/* ˇˇ¸ ° d ONLN dÂw äÉ *CUse CmGetPortInfo to find a QuickTake 100 camera on a serial port. ° d ONLN d)Ö äë ñ **/ ° d ONLN d-ì úü +portIndex = 1; ° d ONLN d=° ú≠ *foundCamera = false; ° d ONLN dSØ úª∞ *.while( (err != kNoPortErr) && (!foundCamera) ) ˇ @ ˇ ˇˇˇˇ @
)B3Sample Code for Retrieving an Image From the Camera 4 ^ *¿¯ ,
Courier
. ° d ONLN d \ l h r ( e l{ ° d ONLN d j ê v +$portInfoHandle = NULL; ° d ONLN d x ê ÑÊ *9err = CmGetPortInfo(camData, portIndex, &portInfoHandle); ° d ONLN d Z Ü ¢ í§ ++if (err != noErr || portInfoHandle == NULL) ° d ONLN d ä î ¥ † ˆ + return err; ° d ONLN d ò ¢ ê Æ ÿ ( ´ ê portIndex++; ° d ONLN d ß ∫ ê Δº *2if ((**portInfoHandle).portStatus == kGeoPortFree) ° d ONLN d › » ¢ ‘ +foundCamera = true; ° d ONLN d Û ÷ ê ‚ ® ( fl êelse ° d ONLN d ˙ ‰ ê ñ *{ ° d ONLN d ˇ Ú ¢ ˛» +1err = CmDisposePortInfo(camData, portInfoHandle); ° d ONLN d5 ¥ +if (err != noErr) ° d ONLN dL Δ + return err; ° d ONLN dZ ê( ñ (% ê} ° d ONLN d]* ~6 Ñ (3 ~} ° d ONLN d`B ~N ‰ *if (!foundCamera) ° d ONLN dtP ê\ +return kGenericErr; ° d ONLN dàh lt ~ (q l/* ° d ONLN dåv lÇå *0Use CmConnect to connect to the camera that was ° d ONLN dΩÑ lêP *&found with the CmGetPortInfo function. ° d ONLN d‰í lû x **/ ° d ONLN dË™ ~∂t +)err = CmConnect(camData, portInfoHandle); ° d ONLN d∏ ~ƒ ‰ *if (err != noErr) ° d ONLN d'Δ ê“ “ + return err; ° d ONLN d3fi lÍ ~ (Á l/* ° d ONLN d7Ï l¯z *-Get the image info with the CmGetPictureInfo ° d ONLN de˙ lÄ *.function and fill in the picture information. ° d ONLN dî l x **/ ° d ONLN dò ~"Ï +=pictureInfo = (CmPictureInfo *)NewPtr(sizeof(CmPictureInfo)); ° d ONLN d◊$ ~0 ‰ *err = MemError(); ° d ONLN dÍ2 ~> ‰ *if (err != noErr) ° d ONLN d˛@ êL “ + return err; ° d ONLN d N ~Z⁄ (W ~:err = CmGetPictureInfo(camData, imageNumber, pictureInfo); ° d ONLN dG\ ~h ‰ *if (err != noErr) ° d ONLN d[j êv “ + return err; ° d ONLN dgÇ lé ~ (ã l/* ° d ONLN dkê lú> *#Allocate the memory for the image. ° d ONLN dèû l™ x **/ ° d ONLN dì¨ ~∏n +(*imageSize = pictureInfo->imageDataSize; ˇ ≤ @ ˇ ˇˇˇˇ @
. ° d ONLN dá äì ∂ (ê äOn the W Û` ° d ONLN d"á µìd )+'indows platform, each of the functions Û` ° d ONLN dIádì≤ )Ø
CmTakePicture Û` ° d ONLN dVá≤ì∑ )N, ° d ONLN dXî ä† ¸ (ù äCmGetThumbnailImage ° d ONLN dkî ¸† )r, ° d ONLN dmî†m )CmGetFullSizeImage ° d ONLN dîm†Ö )l, and ° d ONLN dÖîÖ†Ø )CmErase ° d ONLN dåî؆ı )* has an asynchr R` ° d ONLN dõîı† )Fonous ° d ONLN d°° ä≠ã (™ ä6counterpart whose name is derived by appending the wor R` ° d ONLN d◊°ã≠ì (™ãd R` ° d ONLN dŸ°ì≠± )Async R` ° d ONLN dfi°±≠ ) at the end of the ° d ONLN dÒÆ ä∫ (∑ ä function name (for example, ° d ONLN d
Æ ∫u )CmTakePictureAsync ° d ONLN d Æu∫ )l"). On the Macintosh platform, the ˇ‚ @ ˇ ˇˇˇˇ @
is shown her $¿ ° d ONLN d§ …Œ ’ÿ );e: ° d ONLN d® ‚ l Ó8 ( Î l"typedef void (CallbackProc)(void); ° d ONLN dÀ l ¸ò *2typedef CallballProc* CmAsyncCompletionRoutinePtr; . ° d ONLN d˛ lx *<For a complete description of how to use the application-defi Y† ° d ONLN d;yƒ (yned completion r ¥‡ ° d ONLN dKƒı )K outine, see ° d ONLN dW l! ç ( lthe defi œÄ ° d ONLN d_ ç! ∑ )!
nition on A¿ ° d ONLN di ∏! œ )+page † ° d ONLN dn –! ‚ )2-33 pÄ ° d ONLN dr ‚! Á ). ° d ONLN du' l3 à (0 lAlthough the asynchr ¢ ° d ONLN dâ' Ã3- )`onous functions do pr Δ ° d ONLN dû'-3Ì )a*ovide a means by which an application can ° d ONLN d»4 l@ o (= lr E ° d ONLN d…4 p@ ó ) eceive pr Á‡ ° d ONLN d“4 ó@ • )'ogr ±Ä ° d ONLN d’4 ¶@ Ù )ess information fr …` ° d ONLN dÁ4 Ù@b )Nom an operation asynchr ≠‡ ° d ONLN d˛4b@Ö )nonously
° d ONLN d4Ö@µ )# , neither W P‡ ° d ONLN d4µ@Í )0 indows nor ° d ONLN dA lM ˝ (J l!the Macintosh Finder acts as a pr ◊Ä ° d ONLN d<A ˝Ml )ëeemptive multitasking ar Ê ° d ONLN dTAlMí )o chitectur ö‡ ° d ONLN d]AìM“ )'e. It is still the ° d ONLN dpN lZ o (W lr E ° d ONLN dqN pZs )<esponsibility of the application to implement the callback r n ° d ONLN d≠NsZ€ (Wsoutines within the confi Ä ° d ONLN d≈N‹ZÌ )ines ° d ONLN d…[ lg ã (d lof the r ο ° d ONLN d—[ ãg ) espective operating-system envir ≥¿ ° d ONLN dÒ[ gC )íonment.
u *ɯ 4v *ɯ
° d ONLN d˙t l (| lNote
ˇ·ˇ‚7^
. ° d ONLN dˇÅ lç § * The asynchr R` ° d ONLN d
Å §ç Ë )8onous functions R` ° d ONLN dÅ Ëçx )DCmGetThumbnailImageAsync R` ° d ONLN d2Åxçç )ê and ° d ONLN d7ç lô ˆ (ñ lCmGetFullSizeImageAsync ° d ONLN dNç ˆô )ä ar R` ° d ONLN dQçôô ) !e not available on the Macintosh . ° d ONLN drô l• ï (¢ l platform. ,
Zapf Dingbats
º‡ ° d ONLN d|ú ö§ † ).u
‡ ° d ONLN d}ô °• £ )
≤ *¿¯ 4≥ *¿¯
° d ONLN d± lº (π lNote
ˇ·ˇ‚7^
. ° d ONLN dÑæ l ø *All of the asynchr R` ° d ONLN dñæ ø )Sonous functions R` ° d ONLN d¶æ ì )DCmGetThumbnailImageAsync R` ° d ONLN dææì ò )ê, ° d ONLN d¿ l÷ ˆ (” lCmGetFullSizeImageAsync ° d ONLN d◊ ˆ÷ ˚ )ä, ° d ONLN dŸ ˚÷g )CmTakePictureAsync ° d ONLN dÎ g÷l )l, ° d ONLN dÌ÷ l‚ ¥ (fl l CmEraseAsync ° d ONLN d˘÷ ¥‚ à )H, and ° d ONLN dˇ÷ ÂP )CmCancelAsyncOperation ° d ONLN d÷P‚\ )Ñ ar R` ° d ONLN d÷\‚ü ) e supported by ° d ONLN d'‚ lÓ â (Î lthe W Û` ° d ONLN d,‚ àÓ À )
indows QuickT ` ° d ONLN d9‚ ÀÓ )C
ake 100 DLL. ` ° d ONLN dF‚Ót )=CmTakePictureAsync ` ° d ONLN dX‚tÓâ )l and ° d ONLN d]Ó l˙ ¥ (˜ l CmEraseAsync ° d ONLN diÓ ¥˙ ¿ )H ar R` ° d ONLN dlÓ ¿˙ ) e the only asynchr $¿ ° d ONLN d~Ó˙§ )S!onous functions supported on the . ° d ONLN dü˙ l Δ ( lMacintosh platform.
° d ONLN dfiH lT ¿ (Q lThe device driver r ᇠ° d ONLN dÒH ¿T – )Tefer 4 ° d ONLN dıH —T ¯ )ence defi { ° d ONLN d˛H ¯T )'9nes all of the data types and functions supported by the ° d ONLN d7U la å (^ lQuickT ÄÄ ° d ONLN d=U åa È ) ake 100 device driver £ ° d ONLN dRU Èa Ó )].
ç *ï¯ 4é *ï¯ ê *ê˛
ˇ·ˇ‚7^
° d ONLN dU} *ç S (â *Data T ∏ ° d ONLN d[} Rç à )(ypes for the QuickT ` ° d ONLN dn} Ãçî )z ake 100 Device Driver Functions ˇˇˇˇˇˇ (âÒ2
° d ONLN dèï l°+ (û l.This section describes all of the data types r ¿ ° d ONLN dΩï+°; )øefer ú‡ ° d ONLN d¡ï<°ó )enced by the QuickT ° d ONLN d‘ïó°˜ )[ake 100 device driver ° d ONLN dÍ¢ lÆ æ (´ lfunctions. The defi ˘ ° d ONLN d˝¢ æÆ Á )R
nitions ar ¶Ä ° d ONLN d¢ ËÆU )*e found in the CmDriver Ì@ ° d ONLN d ¢TÆd )l.h fi À` ° d ONLN d#¢eÆπ )le for Macintosh pr Ê ° d ONLN d6¢πÆÔ )T ograms and ° d ONLN dAØ lª ï (∏ l in the QT V` ° d ONLN dJØ ïª » )) AKE-D.H fi Í¿ ° d ONLN dTØ »ª Î )3le for W à ° d ONLN d\Ø Îª )# indows pr Ú@ ° d ONLN deت> )-ograms. ˇ– @ ˇ ˇˇˇˇ @
CameraData ° d ONLN d { ⁄ áé )<( data type is native to the Macintosh pr R` ° d ONLN d B {é á⁄ )¥ogramming envir $¿ ° d ONLN d Q {⁄ á )L onment and . ° d ONLN d \ à ä î ö ( ë ädefi r ° d ONLN d ` à õ î π )ned as . ° d ONLN d h ° ä ≠V ( ™ ä"typedef CmCameraData* CameraData; . ° d ONLN d ã π ä ≈ µ * For the W » ° d ONLN d î π µ ≈ Ô )+ indows envir † ° d ONLN d † π ≈7 );onment it is defi – ° d ONLN d ± π7 ≈S )Gned as . ° d ONLN d ∏ “ ä fi\ ( € ä#typedef unsigned short CameraData; . ° d ONLN d ‹ Í ä ˆ ª *
All QuickT òÄ ° d ONLN d Ê Í ∫ ˆJ )0!ake 100 device driver functions r à† ° d ONLN d ÍJ ˆa )êequir ü‡ ° d ONLN d Ía ˆ˘ )%e a data item of this type as their fi ±‡ ° d ONLN d2 ͢ ˆ )òrst ˇˇU* . ° d ONLN d6 ˜ ä ∫ ( ä parameter ¬† ° d ONLN d? ˜ π € )/ , except ˇ˝ˇ~ lÙ ° d ONLN dH ˜ ‹$ )# CmOpenDriver ˇˇU* Øî ° d ONLN dT ˜#ê )G, which expects the addr ÷ú ° d ONLN dl ˜ê )m!ess of a data item of this type. . ° d ONLN dé ä • ( äFor W j† ° d ONLN dì •º )>indows, the parameter must be the handle of the application pr V` ° d ONLN d— º (ºogram (the variable . ° d ONLN d ä" ¨ ( äthat W Û` ° d ONLN dÎ ´"e )!)indows gives to your application as the fi Û` ° d ONLN de"∞ )∫rst parameter to Û` ° d ONLN d&∞"⁄ )KWinMain Û` ° d ONLN d-⁄"„ )*). Û` ° d ONLN d0„"
) WinMain Û` ° d ONLN d7
" )* . ° d ONLN d8# ä/ Ó (, äand other items specifi ¶ ° d ONLN dO# Ó/ )dcally r ª@ ° d ONLN dV# / )efer g` ° d ONLN dZ#/N )
enced by W ‚ ° d ONLN dd#M/Æ )3indows application pr ? ° d ONLN dy#Ø/€ )b ograms ar å` ° d ONLN dÇ#€/ ), e described ° d ONLN dé0 ä<l (9 ä1in the documentation that accompanies the softwar «Ä ° d ONLN dø0l<} )‚e pr ÿ@ ° d ONLN d√0}< )ogramming envir / ° d ONLN d“0À< )N onment with ° d ONLN dfi= äI ± (F äwhich W ≈¿ ° d ONLN dÂ= ±I )'indows applications ar ]† ° d ONLN d˚=I% )ee cr ‹Ä ° d ONLN dˇ=%IA )eated. ° d ONLN dO ä[ (X äFor the Macintosh computer >` ° d ONLN d!O[€ )}/, this parameter must be the pointer whose addr ‚† ° d ONLN dPO€[Ù )‘ess is . ° d ONLN dW\ äh ∫ (e ä
handed to ° d ONLN da\ ∫h )0 CmOpenDriver ¬† ° d ONLN dm\h )G.
ô H° 4ô H° õ Hõ
ˇ·ˇ‚7^
. ° d ONLN dpã Hô \ (ï HBuf IÄ ° d ONLN dsã \ô { )ferPtr ˇˇˇˇˇˇ (ï2
. ° d ONLN d{´ ä∑ û (¥ äThe ° d ONLN d´ û∑ ‘ ) BufferPtr ° d ONLN dà´ ‘∑h )6" data type is a pointer to an addr R` ° d ONLN d™´h∑
)î&ess containing information to be used . ° d ONLN d–∏ äƒ ı (¡ äby a function or an addr [ ° d ONLN dË∏ ıƒ+ )k
ess used to r ≈ ° d ONLN dı∏+ƒÑ )6eceive information r ° ° d ONLN d ∏ÑƒË )Yeturned by a function. . ° d ONLN d! ä÷
(” äFor the Macintosh platform ° d ONLN d<
÷@ )Ä BufferPtr ° d ONLN dE @÷^ )6 is defi ° d ONLN dM ^÷z ) ned as ° d ONLN dT„ äÔP (Ï ä!typedef unsigned char* BufferPtr; ° d ONLN dv˚ ä ∏ * For the W Û` ° d ONLN d˚ ∑ )-indows platform Û` ° d ONLN dè˚: )M BufferPtr Û` ° d ONLN dò˚:X )6 is defi Û` ° d ONLN d†˚Xt ) ned as ° d ONLN dß ä h ( ä%typedef unsigned char far* BufferPtr;
. ° d ONLN d k l w fi +BCmGetThumbnailImage ° d ONLN d k fi w Ï )r on ° d ONLN d k Ï w )page ° d ONLN d % k w )2-54 ° d ONLN d ) k w ), ° d ONLN d + k w¨ )CmGetThumbnailImageAsync ° d ONLN d C k¨ w∫ )ê on ° d ONLN d G k∫ w“ )page ° d ONLN d L k“ w )2-56 ° d ONLN d P k wÍ ), ° d ONLN d R x l Ñ ÿ ( Å lCmGetFullSizeImage ° d ONLN d d x ÿ Ñ Ê )l on ° d ONLN d h x Ê Ñ ˛ )page ° d ONLN d m x ˛ Ñ )2-57 ° d ONLN d q x Ñ ), ° d ONLN d s x ц )CmGetFullSizeImageAsync ° d ONLN d ä x† ÑÆ )ä on ° d ONLN d é xÆ ÑΔ )page ° d ONLN d ì xΔ ÑŸ )2-60 ° d ONLN d ó xŸ Ñfi ), ° d ONLN d ô Ö l ë ¿ ( é lCmSetOwnerName ° d ONLN d ß Ö ¿ ë Œ )T on ° d ONLN d ´ Ö Œ ë Ê )page ° d ONLN d ∞ Ö Ê ë ˘ )2-40 ° d ONLN d ¥ Ö ˘ ë ), and ° d ONLN d ∫ Ö ëq )CmGetDecompTable ° d ONLN d Öq ë )` on ° d ONLN d Œ Ö ëó )page ° d ONLN d ” Öó ë™ )2-45 ° d ONLN d ◊ Ö™ ë≠ ).
¡ * ¯ 4 ¬ * …¯ √ * √˛
ˇ·ˇ‚7^
. ° d ONLN d Ÿ ¥ * ¬ } ( æ *
CmStdFeatures ˇˇˇˇˇˇ ( æÚ2
ˇˇ€ê . ° d ONLN d Ë ” l fl ( ‹ lThe ˇˇí∞ [ê ° d ONLN d Ï ” Ä fl Œ )
CmStdFeatures ˇˇ€ê [ê ° d ONLN d ˘ ” Œ fl € )N str # ° d ONLN d ˝ ” ‹ fl Ú )uctur ıÄ ° d ONLN d ” Ò fl )e pr £p ° d ONLN d ” fl˜ )6ovides information about the version of the Macintosh . ° d ONLN d< ‡ l Ï å ( È lQuickT ÄÄ ° d ONLN dB ‡ å Ï „ ) ake 100 driver or W ° d ONLN dU ‡ „ Ï )W indows DLL. . ° d ONLN db ˘ l à ( ltypedef struct { ° d ONLN dt ~ “ +short version; ° d ONLN dÉ l!> ( l#} CmStdFeatures, *CmStdFeaturesPtr;
/ *>¯ 4/ *=¯
. ° d ONLN dß. l9 ∏ *Field descriptions
ˇ·ˇ‚7^
. ° d ONLN d∫; lG ñ *version . ° d ONLN d¬; ‰GØ )x+Macintosh: The version number of the QuickT ᆠ° d ONLN dÌ;ØGÌ )Àake 100 driver ° d ONLN d¸G ‰S Ó (P ‰W Û` ° d ONLN d˝G ÌS8 ) indows: The curr = ° d ONLN d
G9Sú )Lent version of the DLL &` ° d ONLN d#GúSû )c
° d ONLN d%m *v Q (t *SEE ALSO
. ° d ONLN d.z lÜ Ã +BCmGetStdFeatures ° d ONLN d>z ÃÜ ⁄ )` on ° d ONLN dBz ⁄Ü Ú )page ° d ONLN dGz ÚÜ )2-35 ° d ONLN dKzÜ )
function to ° d ONLN d˛„ lÔ (Ï l$establish a connection with a QuickT ï ° d ONLN d"„Ôñ )¶ ake 100 camera, you pass the ï ° d ONLN d?„ñÔ“ )Ñ
CmPortInfo ï ° d ONLN dI„“Ô‘ )< . ° d ONLN dJ l¸ w (˘ lstr fi ° d ONLN dM w¸ é ) uctur c‡ ° d ONLN dR è¸î ):e for the port and camera with which you want to connect. . ° d ONLN dç l s ( lY ï ° d ONLN dé r Ç )ou r g` ° d ONLN dí Ç ∑ ) etrieve the g` ° d ONLN dû ∑ Û )5
CmPortInfo g` ° d ONLN d® Û )< str S` ° d ONLN d¨ )uctur %¿ ° d ONLN d±S )e for a specifi %¿ ° d ONLN d¿SΩ )<ed serial port with the ° d ONLN dÿ l ∫ ( l
CmGetPortInfo ° d ONLN d ∫  )N function. ° d ONLN dÒ( l4 à (1 ltypedef struct { ° d ONLN d6 ~B ¢ +Handle ° d ONLN d6 ÿB )Z portIcon; ° d ONLN dD ~P “ (M ~StringHandle ° d ONLN d,D ÿP )Z portName; ° d ONLN d7R ~^ “ ([ ~unsigned long ° d ONLN dJR ÿ^ )Z portStatus; ° d ONLN dW` ~l (i ~StringHandle appName; ° d ONLN dpn ~z *unsigned char familyID; ° d ONLN dä| ~à *unsigned char deviceID; ° d ONLN d§ä ~ñ *unsigned short beaconParam; ° d ONLN d¡ò ~§ ® *Handle ° d ONLN dÕò ÿ§ )Z portConfig; ° d ONLN d⁄¶ ~≤ à (Ø ~
portStatus ° d ONLN d! ¨ ∏ )xThe ° d ONLN d% ¨ ∏R )
portStatus ° d ONLN d/ ¨R ∏[ )< fi ° d ONLN d2 ¨[ ∏Ù ) #eld contains one of these symbolic . ° d ONLN dU ∏ ƒ∫ ( ¡,constants indicating the status of the port: . ° d ONLN dÇ « ”J * kGeoPortFree . ° d ONLN dè «t ”{ )rA ∫† ° d ONLN dê «{ ” ) GeoPort device is attached on ° d ONLN dØ ”t flº ( ‹tthis port and is r =@ ° d ONLN d¡ ”Ω flÍ )I
eady to pr 0¿ ° d ONLN dÀ ”Í fl )-ocess ° d ONLN d— flt ÎÆ ( Ët commands fr –¿ ° d ONLN d‹ flÆ Î‰ ): om the host. . ° d ONLN dÈ Ó ˙8 ( ˜ kPortFree . ° d ONLN dÙ Ót ˙{ )rA ∫† ° d ONLN dı Ó{ ˙û ) QuickT ; ° d ONLN d¸ Óû ˙ )#ake 100 camera is attached ° d ONLN d ˙t (ton this port and is r ° d ONLN d, ˙À¯ )W
eady to pr ˜† ° d ONLN d6 ˙˜ ),ocess ° d ONLN d<tÆ (t commands fr –¿ ° d ONLN dGƉ ): om the host. . ° d ONLN dT!\ ( kInUseByGeoPort . ° d ONLN ddt!{ )rA ∫† ° d ONLN de{!∫ )
Qí]√ ) espectively Ä ° d ONLN dQ√]» )1. . ° d ONLN d`lV (ikInUseBySerial . ° d ONLN d*`tl )r$Another serial application is using ° d ONLN dNltx∂ * the serial port. . ° d ONLN d`{á\ (ÑkInUseByUnknown . ° d ONLN dp{tá )r$Another serial application is using ° d ONLN dîátì∂ * the serial port. . ° d ONLN d¶ñ¢h (ükInUseByLocalTalk . ° d ONLN d∏ñt¢• )r
The LocalT €` ° d ONLN d¬ñ§¢ )0alk driver is using the ° d ONLN d⁄¢tÆ• (´t
serial port. . ° d ONLN d˱ äΩ ¥ (∫ äappName . ° d ONLN d±Ω )xNull. . ° d ONLN d˜¿ äà ∫ (… äfamilyID . ° d ONLN d ¿Ã{ )xThe GeoPort family identifi ÆÄ ° d ONLN d¿{Ã
)y"cation for digital image devices. ° d ONLN d=ÃÿG (’
When a QuickT χ ° d ONLN dJÃFÿÿ )D"ake 100 camera is attached, this fi › ° d ONLN dmßÿ )ì
eld contains . ° d ONLN dzÿ‰î (· the value 1 and has the constant ° d ONLN döÿî‰∞ )í name ° d ONLN d†ÿ∞‰Ú ) kCmFamilyID ° d ONLN d´ÿÚ‰˜ )B. ° d ONLN dÆÁ äÛ ∫ ( ädeviceID . ° d ONLN d∑ÁÛ{ )xThe GeoPort device identifi ‘† ° d ONLN d“Á{Û )y cation for the camera. When a ° d ONLN dÛˇ" (¸QuickT ÄÄ ° d ONLN dˆÛ"ˇ¥ ) "ake 100 camera is attached, this fi p¿ ° d ONLN dÛµˇ˝ )ìeld contains the . ° d ONLN d*ˇ û ("value 1 and has the constant name ° d ONLN dLˇû ‡ )ú kCmDeviceID ° d ONLN dWˇ‡ „ )B. ° d ONLN dY ä à ( ä beaconParam . ° d ONLN de )x*The GeoPort beacon parameter of the QuickT ¿ ° d ONLN dè )»ake 100 camera. ° d ONLN dü&< (#This value is ú@ ° d ONLN d≠<&K ):256 ú@ ° d ONLN d∞K&M ). . ° d ONLN d≤) ä5 Δ (2 ä
portConfig . ° d ONLN dΩ)5µ )x&Operating system dependent. Reserved. . ° d ONLN d‰8 äD ¿ (A ä DataSpeed . ° d ONLN dÓ8D )x=The data transfer rate in bits per second of this port. Befor O‡ ° d ONLN d+8D )ˇe an ° d ONLN d0DPÎ (M5actual camera connection is made, the value of this fi Å` ° d ONLN dfDÎP )È
eld is 0. ° d ONLN dpP\û (Y$After the connection is made, this fi O¿ ° d ONLN dïPü\Á )ùeld contains the ° d ONLN d¶\h (eappr I@ ° d ONLN d™\h )2opriate value for the data transfer rate. See the . ° d ONLN d‹htT (qdescription of the ° d ONLN dÔhTt¢ )R
CmGetPortInfo ° d ONLN d¸h¢t÷ )N
function on ° d ONLN d h÷tÓ )4page ° d ONLN dhÓt )2-22 ° d ONLN dht ) ° d ONLN dtÄ (}and ° d ONLN dtÄK ) CmConnect ° d ONLN d tKÄ )6
function on ° d ONLN d-tÄó )4page ° d ONLN d2tóÄ™ )2-25 ° d ONLN d6t™Äà ) for mor R` ° d ONLN d>tÃÄ )"e information . ° d ONLN dLÄåw (âabout data transfer speed. ˇÜ @ ˇ ˇˇˇˇ @
. ° d ONLN d j l v ¢ +B CmConnect ° d ONLN d j ¢ v ∞ )6 on ° d ONLN d j ∞ v » )page ° d ONLN d j » v € )2-25 ° d ONLN d j € v ‡ ), ° d ONLN d ! j ‡ v. )
CmGetPortInfo ° d ONLN d . j. v0 )N ° d ONLN d / j0 vH )page ° d ONLN d 4 jH v[ )2-22 ° d ONLN d 8 j[ v` ), ° d ONLN d : j` vΔ )CmDisposePortInfo ° d ONLN d K jΔ v‘ )f on . ° d ONLN d O w l É É ( Ä lpage Z‡ ° d ONLN d T w Ñ É ñ )2-24 Æ¿ ° d ONLN d X w ñ É ò )
≥ * º¯ 4 ¥ * ª¯ µ * µ˛
ˇ·ˇ‚7^
° d ONLN d Z ¶ * ¥ ( ∞ *
CmProductInfo ˇˇˇˇˇˇ ( ∞Ú2
. ° d ONLN d i ≈ l — Ä ( Œ lThe ° d ONLN d m ≈ Ä — Œ )
CmProductInfo ° d ONLN d z ≈ Œ — ‹ )N str l ° d ONLN d ~ ≈ ‹ — Ú )uctur >` ° d ONLN d É ≈ Ú — )e pr ¿ ° d ONLN d á ≈ —- ) ovides pr „ ° d ONLN d ê ≈, —f )) oduct-specifi „ ° d ONLN d ù ≈f —— ):c information about the . ° d ONLN d µ “ l fi å ( € lQuickT ÄÄ ° d ONLN d ª “ å fi ‘ ) ake 100 camera. . ° d ONLN d à Πl ˜ à ( Ù ltypedef struct { ° d ONLN d › ˘ l ú * char ° d ONLN d Ê ˘ ú ¢ )0 ° d ONLN d Ì ˘ Í> )NvendorName[8]; ° d ONLN d ¸ l ú ( l char ° d ONLN d ÍÜ )~productIdentification[16]; ° d ONLN d& l! “ ( l unsigned char ° d ONLN d> Í!h )~hardwareVersion[2]; ° d ONLN dT# l/ “ (, l unsigned char ° d ONLN dl# Í/\ )~firmwareVersion[2]; ° d ONLN dÄ1 l=> (: l#} CmProductInfo, *CmProductInfoPtr;
¿r )&e version of the camera: ° d ONLN d¿ ‰Ãõ (… ‰(Byte 0 contains the major version number ô ° d ONLN d,¿õÃù )∑. ° d ONLN d.à ‰ÿù (’ ‰(Byte 1 contains the minor version number ¸ ° d ONLN dVÃúÿ° )∏.
° d ONLN dYÚ *˚ Q (˘ *SEE ALSO
. ° d ONLN dbˇ l à +BCmGetProductInfo ° d ONLN drˇ à ⁄ )` on ° d ONLN dvˇ ⁄ Ú )page ° d ONLN d{ˇ Ú )2-37 ° d ONLN dˇ
).
< *D¯ 4< *D¯ > *>˛
ˇ·ˇ‚7^
. ° d ONLN dÇ. *< w (8 *
CmDateAndT '¿ ° d ONLN då. w< ã )Mime ˇˇˇˇˇˇ (8Ú2
. ° d ONLN dëN lZ Ä (W lThe ° d ONLN dïN ÄZ Œ )
CmDateAndTime ° d ONLN d¢N ŒZ ‹ )N str l ° d ONLN d¶N ‹Z Ú )uctur >` ° d ONLN d´N ÚZC )e contains the curr ¿ ° d ONLN dæNCZ≈ )Q ent date and time of a specifi ¿ ° d ONLN d‹N≈Z“ )Çed . ° d ONLN dfl[ lg å (d lQuickT ÄÄ ° d ONLN dÂ[ åg ‘ ) ake 100 camera. . ° d ONLN dˆt lÄ Ã (} ltypedef struct { ° d ONLN dÇ ~é Ã +
unsigned char ° d ONLN dÇ Íé )lmonth; ° d ONLN d#ê ~ú Ã (ô ~
unsigned char ° d ONLN d6ê Íú )lday; ° d ONLN d<û ~™ Ã (ß ~
unsigned char ° d ONLN dOû Í™ )lyear; ° d ONLN dV¨ ~∏ Ã (µ ~
ÿ )x/Second of the minute. Number in the range 0 thr û` ° d ONLN dR
ÿ˝ )÷ough 59.
° d ONLN d[2 H; o (9 HSEE ALSO
. ° d ONLN dd@ äL Í +BCmSetDateAndTime ° d ONLN dt@ ÍL ¯ )` on ° d ONLN dx@ ¯L )page ° d ONLN d}@L# )2-39 ° d ONLN dÅ@#L( ), ° d ONLN dÉ@(LÇ )CmGetCameraInfo ° d ONLN dí@ÇLê )Z on ° d ONLN dñ@êL® )page ° d ONLN dõ@®Lª )2-28 ° d ONLN dü@ªL¿ ), ° d ONLN d°M äY Í (V äCmGetPictureInfo ° d ONLN d±M ÍY ¯ )` on ° d ONLN dµM ¯Y )page ° d ONLN d∫MY# )2-29 ° d ONLN dæM#Y% )
â Hí 4ä Hë ã Hã
ˇ·ˇ‚7^
. ° d ONLN d¿| Hä ã (Ü H CmInterface ˇˇˇˇˇˇ (Ü2
. ° d ONLN dÕõ äß û (§ äThe ° d ONLN d—õ ûß ‡ ) CmInterface ° d ONLN d‹õ ‡ß Ó )B str l ° d ONLN d‡õ Óß )uctur >` ° d ONLN dÂõß )e defi >` ° d ONLN dÎõ ߸ )/nes the communication parameters for the QuickT S` ° d ONLN dõ˚ß )fiake . ° d ONLN d ® ä¥ (± ä 100 camera attached to a host r â ° d ONLN d=®¥> )àunning W o ° d ONLN dE®>¥Ñ ),indows. This str C† ° d ONLN dU®Ö¥ú )Guctur …Ä ° d ONLN dZ®ú¥· )e is one of the fi ¸Ä ° d ONLN dl®·¥ )E elds in the . ° d ONLN dxµ ä¡ “ (æ ä CmCameraInfo ° d ONLN dѵ “¡ ‡ )H str l ° d ONLN dൠ‡¡ ˆ )uctur >` ° d ONLN dçµ ˆ¡ )e def ‡ ° d ONLN díµ ¡. )ined on ‡ ° d ONLN döµ.¡F )"page ‡ ° d ONLN düµF¡Y )2-14 ‡ ° d ONLN d£µY¡^ ). ° d ONLN d¶Œ ä⁄ Í (◊ ätypedef struct { ° d ONLN d∏‹ úË Í +
unsigned char ° d ONLN dÀ‹ËV )l
transferRate; ° d ONLN d⁄Í úˆ Í (Û ú
unsigned char ° d ONLN dÌ͈\ )lconfiguration; ° d ONLN d˝¯ ú Í ( ú
unsigned char ° d ONLN d¯8 )ltimeOut; ° d ONLN d ä fi ( ä} CmInterface;
H/ 4 H.
. ° d ONLN d( ä* ÷ *Field descriptions
ˇ·ˇ‚7^
. ° d ONLN d;, ä8 “ * transferRate . ° d ONLN dH,8¸ )x:Indicates the data transfer rate between the host and the ° d ONLN dÇ8D * @camera.The transfer rate in bits per second (bps) is calculated ° d ONLN d¬DP∫ * *by multiplying 1200 by the value of this fi ™@ ° d ONLN dÌD∫P )∏eld. For example, a ° d ONLN dP\Ç (Y value of 2 indicates 2400 bps. . ° d ONLN d _ äk ÿ (h ä
configuration . ° d ONLN d._k )x@Indicates the serial communication settings. It contains 8 bits ° d ONLN dnkw¸ * =MSB-LSB as follows: parity (2 bits), stop bits (1 bit), data ° d ONLN d´wÉä * "length (2 bits), unused (3 bits). ° d ONLN dœÜí *Parity ° d ONLN d◊Ü>íd )< Stop bits ° d ONLN d·Üzí≠ )< Data length ° d ONLN dÌíû/ (õ 00 = None ° d ONLN d¯í>ûa )< 0 = 1 bit ° d ONLN dízû¶ )< 10 = 7 bits ° d ONLN dû™+ (ß01 = Odd ° d ONLN dû>™e )<
1 = 2 bits ° d ONLN d#ûz™ )<1 Û` ° d ONLN d$û~™• )
1 = 8 bits ° d ONLN d/™∂ (≥1 Û` ° d ONLN d0™∂, )1 = Even ˇ† @ ˇ ˇˇˇˇ @
° d ONLN d \ ‰ h Î ( e ‰A ∫† ° d ONLN d \ Î h ) value of 1 ÷¿ ° d ONLN d \ h' )-101 J ° d ONLN d \' h¥ ) 1000 would indicate even parity ˘¿ ° d ONLN d . \≥ hÌ )å, 1 stop bit, 8 ° d ONLN d > h ‰ t ( q ‰
data bits. ,
Courier . ° d ONLN d I w l É ñ ( Ä ltimeOut . ° d ONLN d Q w ‰ É◊ )x5Indicates the timeout period beyond which the camera ° d ONLN d Ü É ‰ è * >decides that the host timed out. The actual timeout period is . ° d ONLN d ƒ è ‰ õ% * ten times the r R` ° d ONLN d ” è% õu )Aeturned value (10 R` ° d ONLN d  èu õz )Px R` ° d ONLN d Ê èz õ| ) R` ° d ONLN d Á è| õ¶ )timeOut R` ° d ONLN d Ó è¶ õÍ )*) milliseconds. Ù ° d ONLN d ˛ èÈ õÒ )CA g` ° d ONLN d ˇ èÒ õÛ ) ° d ONLN d õ ‰ ß ( § ‰timeOut ° d ONLN d õ ß7 )*
value of ° d ONLN d õ7 ß= ))0 ° d ONLN d õ= ß‹ )% indicates no timeout. This value is ° d ONLN d7 ß ‰ ≥0 ( ∞ ‰implicitly set to ° d ONLN dI ß0 ≥B )L255 ° d ONLN dL ßB ≥á ), which is appr R` ° d ONLN d[ ßá ≥Î )Eoximately 2.5 seconds.
‚ * ί 4 „ * ͯ ‰ * ‰˛
ˇ·ˇ‚7^
. ° d ONLN dr ’ * „ ~ ( fl * CmCameraInfo ˇˇˇˇˇˇ ( flÚ2
. ° d ONLN dÄ Ù l Ä ( ˝ lThe ° d ONLN dÑ Ù Ä » ) CmCameraInfo ° d ONLN dê Ù » ÷ )H str l ° d ONLN dî Ù ÷ Ï )uctur >` ° d ONLN dô Ù Ï « )0e contains detailed information about the specifi >` ° d ONLN d Ù« ‘ )€ed . ° d ONLN dÕ l
å (
lQuickT ÄÄ ° d ONLN d” å
C ) 'ake 100 camera and imaging parameters. . ° d ONLN d˚ l& Ã (# ltypedef struct { ° d ONLN d
CmDateAndTime ° d ONLN d7ä ÍñV )lcameraDateAndTime; ° d ONLN dKò ~§ Ã (° ~
unsigned char ° d ONLN d^ò ͧ& )l
flashMode; ° d ONLN dj¶ ~≤ “ (Ø ~unsigned short ° d ONLN d~¶ Í≤8 )l
exposureTime; ° d ONLN dç¥ ~¿ “ (Ω ~unsigned short ° d ONLN d°¥ Í¿ )lFNumber; ° d ONLN d´¬ ~Œ à (À ~
unsigned char ° d ONLN dæ¬ ÍŒ2 )l pictureMode; ° d ONLN dÖ ~‹ à (Ÿ ~
unsigned char ° d ONLN dfl– Í‹ )lreserved ° d ONLN dÈfi ~Í Ã (Á ~
unsigned char ° d ONLN d¸fi ÍÍh )lfullImageDatCompMode; ° d ONLN dÏ ~¯ à (ı ~
unsigned char ° d ONLN d&Ï Í¯n )lthumbImageDatCompMode; ° d ONLN d>˙ ~ à ( ~
unsigned long ° d ONLN dQ˙ ÍJ )ltotalMemorySize; ° d ONLN dc ~ Ã ( ~
unsigned long ° d ONLN dv ÍD )lfreeMemorySize; ° d ONLN dá ~" ñ ( ~char ° d ONLN dë Í"> )lownerName[32]; ° d ONLN d°$ ~0 Ã (- ~
unsigned char ° d ONLN d¥$ Í0> )lCCDSensorType; ° d ONLN dƒ2 ~> ¿ (; ~ CmInterface ° d ONLN d’2 Í>∞ )l!hostInterface; /* Windows only */ ° d ONLN d¯@ ~L Ã (I ~
unsigned char ° d ONLN d @ ÍLÜ )lcameraInformationBytes[6]; ° d ONLN d'N ~Z Ã (W ~
unsigned char ° d ONLN d:N ÍZÜ )lcompDecompParamVersion[4]; ° d ONLN dV\ ~h à (e ~
unsigned char ° d ONLN di\ Íhn )lcolorMatrixVersion[4]; ° d ONLN dÅj ~v à (s ~
unsigned char ° d ONLN dîj Ívn )lspareImageMemoryBlock; ° d ONLN d¨x ~Ñ “ (Å ~unsigned short ° d ONLN d¿x ÍÑb )lnoBasePicturesTaken; ° d ONLN d÷Ü ~í “ (è ~unsigned short ° d ONLN dÍÜ Íít )lnoQuarterPicturesTaken; ° d ONLN dî ~† à (ù ~
unsigned char ° d ONLN dî ͆, )l sleepDelay; ° d ONLN d"¢ lÆn (´ l+} CmCameraInfo, FarPointer CmCameraInfoPtr; ˇ∏ @ ˇ ˇˇˇˇ @
( ŸÄ battery icon in the LCD display ° d ONLN dÆ ‹Ä ˲ * is full and the adapter is not ° d ONLN dÕ ËÄ ÙØ *
connected. . ° d ONLN dÿ ˜Ä ( kBatteryIconFull = 86 . ° d ONLN dÓÜ +} V Õ ° d ONLN dÔÖß )alues gr ó` ° d ONLN d˜® )#eater than or equal to 86 ° d ONLN d
( show a battery icon in the LCD ° d ONLN d0' * %display that is full; the adapter is ° d ONLN dU'3ø * not connected. . ° d ONLN dd6BÄ (?kBatteryIconHalf = 80 . ° d ONLN dzBÄNá +~ V Õ ° d ONLN d{BÜNÛ )alues between 85 and 80 ° d ONLN dìNÄZ (WÄ"indicate that the battery is half ° d ONLN dµZÄfì * char ܆ ° d ONLN dπZìf® )ged; ˚ ° d ONLN dæZ®f
)the battery icon in the ° d ONLN d÷fÄr
(oÄ!LCD display is half full and the ° d ONLN d˜rÄ~Ó * adapter is not connected. . ° d ONLN dÅçå (äkBatteryRangeEmpty = 75 . ° d ONLN d)çô÷ +} Battery has an insuf Ô¿ ° d ONLN d=ç÷ô‹ )Wfi ¸Ä ° d ONLN d?ç‹ô )
CmDateAndTime ° d ONLN d bPnv )N data str l ° d ONLN d(bvnå )&uctur >` ° d ONLN d-bånà )e described on >` ° d ONLN d<bÃn‰ )@page >` ° d ONLN dAb‰n˜ )2-12 >` ° d ONLN dEb˜n˙ ). ° d ONLN dGq ä} ¿ (z ä flashMode . ° d ONLN dQq} )xThe fl »Ä ° d ONLN dWq}à )ash mode of the camera. . ° d ONLN dp}â (Ü0 ° d ONLN dq}â ) = !† ° d ONLN dt}âH )
Automatic f Ú ° d ONLN d}Gâv )5 lash mode ° d ONLN dââï (í1 ° d ONLN däâïE ) = Never use f PÄ ° d ONLN dòâEïZ )=lash ° d ONLN dùï° (û2 ° d ONLN dûï° ) = !† ° d ONLN d°ï°L )
Always use f Ú ° d ONLN d≠ïK°` )9lash ° d ONLN d≤°≠ (™The fl ° d ONLN d∏° ≠Ö )ash mode can be modifi ° d ONLN dŒ°Ö≠Ω )h ed with the ° d ONLN d⁄°Ω≠ )8CmSetFlashMode ° d ONLN dË°≠ )T . ° d ONLN dÈ≠πd (∂function described on /¿ ° d ONLN dˇ≠eπ| )cpage
† ° d ONLN d≠}πè )2-42 ^Ä ° d ONLN d≠èπë ). ˇ B @ ˇ ˇˇˇˇ @
. ° d ONLN d \ l h ¥ ( e l exposureTime . ° d ONLN d
\ ‰ hB )xIndicates the exposur Ω† ° d ONLN d " \B h£ )^e time that would be r ¿ ° d ONLN d 8 \§ hª )bequir + ° d ONLN d = \ª h )
ed to take a ˇˇ∑¬ . ° d ONLN d J h ‰ t ˇ ( q ‰pictur R` ° d ONLN d P h ˇ tL )e at the time of a ˇˇ'F †Ï ° d ONLN d c hL t¶ )MCmGetCameraInfo ˇˇ∑¬ †Ï ° d ONLN d r h¶ t˜ )Z function call. The . ° d ONLN d Ü t ‰ Äó ( } ‰*value is the inverse of the actual exposur @‡ ° d ONLN d ∞ tò Ä⁄ )¥e time. That is, . ° d ONLN d ¡ Ä ‰ å ( â ‰exposur R` ° d ONLN d » Ä å< )"
e time is (1/ R` ° d ONLN d ’ Ä< åÑ )6 exposureTime R` ° d ONLN d · ÄÑ åÆ )H
) seconds. ° d ONLN d Ï è l õ ñ ( ò lFNumber . ° d ONLN d Ù è ‰ õ Î )xA ∫† ° d ONLN d ı è Î õ‘ )9 function of focal length of the lens of the camera, its . ° d ONLN d. õ ‰ ß ( § ‰diameter ¬† ° d ONLN d6 õ
ßy )), and the shutter speed. ¬† ° d ONLN dO õy ßÖ )l28 ¬† ° d ONLN dQ õÖ ßä ) , ¬† ° d ONLN dS õä ßñ )30 ¬† ° d ONLN dU õñ ßõ ) , ¬† ° d ONLN dW õõ ßß )35 ¬† ° d ONLN dY õß ß¨ ) , ¬† ° d ONLN d[ õ¨ ß∏ )40 ¬† ° d ONLN d] õ∏ ßΩ ) , ¬† ° d ONLN d_ õΩ ß… )49 ¬† ° d ONLN da õ… ߌ ) , ¬† ° d ONLN dc õŒ ß⁄ )63 ¬† ° d ONLN de õ⁄ ßfl ) , ¬† ° d ONLN dg õfl ßÎ )90 ¬† ° d ONLN di õÎ ßÌ ) ° d ONLN dj ß ‰ ≥ ˜ ( ∞ ‰and ° d ONLN dn ß ˜ ≥ )160 ° d ONLN dq ß ≥ ) ar R` ° d ONLN dt ß ≥Ñ ) e the possible values for R` ° d ONLN dé ßÑ ≥Æ )oFNumber ï ° d ONLN dï ß≠ ≥∞ )). ° d ONLN dó ∂ l ¬ Æ ( ø l pictureMode . ° d ONLN d£ ∂ ‰ ¬ )xSpecifi ‡ ° d ONLN d™ ∂ ¬Ñ ) es the image size of the pictur È ° d ONLN d… ∂Ñ ¬¿ )Ée to be taken. . ° d ONLN dŸ ¬ ‰ Œ ( À ‰16 ° d ONLN d€ ¬ ŒF ) = subsequent pictur R` ° d ONLN dÔ ¬F Œí )Ves will be high-r $¿ ° d ONLN d ¬í Œæ )L
esolution. ° d ONLN d Œ ‰ ⁄ ( ◊ ‰32 ° d ONLN d
Œ ⁄F ) = subsequent pictur R` ° d ONLN d! ŒF ⁄ñ )Ves will be standar $¿ ° d ONLN d3 Œñ ⁄§ )Pd-r ˜ ° d ONLN d6 Œ£ ⁄Ë )
esolution. This ° d ONLN dF ⁄ ‰ Êp ( „ ‰ value can be changed with the ° d ONLN dd ⁄p Ê– )åCmSetPictureMode ° d ONLN dt ⁄– ʯ )`
function . ° d ONLN d~ Ê ‰ Ú ( Ô ‰
described on °Ä ° d ONLN dã Ê Ú6 );page |` ° d ONLN dê Ê7 ÚI )2-41 –@ ° d ONLN dî ÊI ÚK ). . ° d ONLN dñ ı l ú ( ˛ lreserved . ° d ONLN dü ı ‰ )x
Reserved. . ° d ONLN d™ l ‰ (
lfullImageDatCompMode . ° d ONLN dø ‰ ` +x Method employed to compr é¿ ° d ONLN d◊` „ )| ess image data in the camera. ° d ONLN dı ‰(E (% ‰Always 1 adaptive dif µ† ° d ONLN d
E(Q )afer ò ° d ONLN d
Q(‘ ) ential pulse code modulation ° d ONLN d*( ‰4 (1 ‰(ADPCM). . ° d ONLN d37 lC Í (@ lthumbImageDatCompMode . ° d ONLN dIC ‰O` +x Method employed to compr é¿ ° d ONLN daC`Oƒ )|ess thumbnail images. fi¿ ° d ONLN dwCƒOÔ )d Always 3 ° d ONLN dÄO ‰[Y (X ‰ (4 bits shifted to the right). . ° d ONLN dü^ lj Δ (g ltotalMemorySize . ° d ONLN dØ^ ‰j Í )xT µ¿ ° d ONLN d∞^ Èjñ )(otal size of memory available for pictur M ° d ONLN dÿ^ójÒ )Æe storage in number ° d ONLN dÏj ‰v (s ‰ of bytes. . ° d ONLN dˆy lÖ ¿ (Ç lfreeMemorySize . ° d ONLN dy ‰Öí )x%Remaining memory available for pictur
CCDSensorType . ° d ONLN ds” ‰fl Í )xT ∫¿ ° d ONLN dt” Èfl6 )ype of CCD (char §¿ ° d ONLN dÑ”6fl® )Mged couple device) sensor ˚¿ ° d ONLN dù”ßfl¨ )q. . ° d ONLN d†fl ‰Î Í (Ë ‰0 ° d ONLN d°fl ÍÎ- )
= Kodak M7-L ° d ONLN dØÎ ‰˜ Í (Ù ‰1 ° d ONLN d∞Π͘# ) = Kodak M7 ° d ONLN dº˙ l ∫ ( l
hostInterface . ° d ONLN d ˙ ‰« )x1Serial communication parameters (only valid for W † ° d ONLN d˚˙« )„ indows). ° d ONLN d ‰ ˇ ( ‰This fi $@ ° d ONLN d › ) 2eld is valid only if the underlying communication ° d ONLN d= ‰ > ( ‰device is the standar ‚ ° d ONLN dR> Ó )Z)d serial interface. The parameter values . ° d ONLN d{ ‰* Ó (' ‰ar R` ° d ONLN d} Ó*@ )
e contained in the R` ° d ONLN dê @*à )R transferRate R` ° d ONLN dú à*ç )H, R` ° d ONLN dû ç*€ )
configuration R` ° d ONLN d´ €*Û )N, and ° d ONLN d±* ‰6 (3 ‰timeOut ° d ONLN d∏*6 )* f PÄ ° d ONLN d∫*6J )
ields in the PÄ ° d ONLN d«*J6å )6 CmInterface PÄ ° d ONLN d“*å6ö )B str <Ä ° d ONLN d÷*ö6∞ )uctur ‡ ° d ONLN d€*∞6 )e described on . ° d ONLN dÍ6 ‰B ˚ (? ‰page Z‡ ° d ONLN dÔ6 ¸B )2-13 Æ¿ ° d ONLN dÛ6B ). . ° d ONLN dıE lQ (N lcameraInformationBytes . ° d ONLN d Q ‰] +x Reserved. . ° d ONLN d` ll (i lcompDecompParamVersion . ° d ONLN d-l ‰xu +x !The version number of the set of ’† ° d ONLN dNlux∫ )ë ADPCM compr ‡ ° d ONLN dYl∫x◊ )Eession ° d ONLN d`x ‰Ñä (Å ‰#parameters employed by the camera. . ° d ONLN dÑá lì ÿ (ê lcolorMatrixVersion . ° d ONLN dóá ‰ìÜ )x$The version number of the color corr u@ ° d ONLN dªáÜìÒ )¢ection matrix employed ° d ONLN d“ì ‰üî (ú ‰(by the camera. Bytes 0 and 1 together ar {@ ° d ONLN d˙ìîüÎ )∞e the major version ° d ONLN dü ‰´ (® ‰number ≥ ° d ONLN dü´x )". Bytes 2 and 3 together ar π† ° d ONLN d/üx´Û )re the minor version number X@ ° d ONLN dIüÛ´¯ ){. ˇ> @ ˇ ˇˇˇˇ @
, (‡2-17 4 ^ H¿ . ° d ONLN d \ hx ( eSee the description of the ,
Courier ° d ONLN d \x hΔ )v
CmColorMatrix ° d ONLN d ( \Δ hÏ )N data str l ° d ONLN d 1 \Ï h )&uctur >` ° d ONLN d 6 \ h )e on . ° d ONLN d ; h t ( qpage Z‡ ° d ONLN d @ h t, )2-19 Æ¿ ° d ONLN d D h, t1 ). ° d ONLN d H w É≤ ( Ä&Since the color matrix and image compr d ° d ONLN d n w≤ É )∞ession schemes in the ° d ONLN d Ñ É èé ( å camera may change in the futur – ° d ONLN d ¢ Éé è )å e, it is always important to ° d ONLN d ø è õÕ ( ò.check the version number of the color matrix. pÄ ° d ONLN d Ì èÕ õ” )ÀY 1 ° d ONLN d Ó è” õ )
ou must make ° d ONLN d ˚ õ ßÑ ( § adjustments in your image pr ˚¿ ° d ONLN d õÑ ß )Ç ocessing setup, based on the ° d ONLN d4 ß ≥ ( ∞<version number of the color matrix in the camera as follows: ° d ONLN dr ∂ ¬, *On the W ~ ° d ONLN dz ∂, ¬ )*6indows platform, if the color matrix in the camera is ° d ONLN d∞ ¬ Œ— ( À0version 1, use the default color matrix in the W ˇ¿ ° d ONLN d‡ ¬– Œ )Œ indows IPM ° d ONLN dÎ Œ ⁄› ( ◊1and pass that matrix back to the IPM for image pr Î@ ° d ONLN d Œ› ⁄ )€
ocessing. If ° d ONLN d) ⁄ ʵ ( „,it is not version 1, pass the color matrix r ñ‡ ° d ONLN dU ⁄µ ʯ )≥eturned by the ° d ONLN dd Ê Úi ( Ôcamera to the IPM. See Δ ° d ONLN d{ Êi ÚÚ )g Chapter 5, “Displaying QuickT T‡ ° d ONLN dò ÊÚ Ú )âake 100 ° d ONLN d† Ú ˛g ( ˚Images in a Macintosh ° d ONLN d∂ Úh ˛° )f Application” á@ ° d ONLN d¬ Ú° ˛ƒ )9 for mor Q¿ ° d ONLN d Ú≈ ˛ )$e information ° d ONLN dÿ ˛
ô ( about displaying images on the W 4 ° d ONLN d¯ ˛ô
ake QuickT Ä ° d ONLN d€1e=ü )3 ime decompr Å¿ ° d ONLN dÊ1ü= ):essor with the camera ° d ONLN d¸=Iº (F,color matrix. If the version number is 1, pr † ° d ONLN d(=ΩI
)ªocess and display ° d ONLN d:IU| (Rthe images with the QuickT ‡Ä ° d ONLN dTI{U¥ )y ake decompr Ä ° d ONLN d_IµU ):essor using the same ° d ONLN dtUa| (^method you use for QuickT ˜ ° d ONLN dçU{a≠ )y
ime PICT fi )† ° d ONLN dòUÆa– )3 les. See k† ° d ONLN d°U–a )" Chapter 5, ° d ONLN d¨am[ (j“Displaying QuickT •† ° d ONLN dæaZm„ )X ake 100 Images in a Macintosh ° d ONLN d‹my; (v Application” ˛ ° d ONLN dËm;y^ )9 for mor »† ° d ONLN dm_yÍ )$ e information about displaying ° d ONLN dyÖ" (ÇQuickT ÄÄ ° d ONLN dy"Ö˚ ) .ake images on the Macintosh computer platform. . ° d ONLN dDà äî (ë äspareImageMemoryBlock . ° d ONLN dZî†H +x Number of spar ª` ° d ONLN dhîH†» )F e image blocks still available. . ° d ONLN d࣠äØ ¸ (¨ änoBasePicturesTaken . ° d ONLN dú£ØP )xNumber of high-r Í` ° d ONLN d¨£PØ˚ )N&esolution images that have been taken. . ° d ONLN d”≤ äæ (ª änoQuarterPicturesTaken . ° d ONLN dÍæ V +x Number of standar Ë¿ ° d ONLN d˚æV c )Td-r ` ° d ONLN d˛æd )&esolution images that have been taken. . ° d ONLN d%Õ äŸ Δ (÷ ä
sleepDelay . ° d ONLN d0ÕŸé )x Sleep delay time of the camera. +† ° d ONLN dPÕéŸï )åA f@ ° d ONLN dQÕïŸ ) numeric value in the range . ° d ONLN dmŸÂ (‚0 ° d ONLN dnŸÂ ) thr R` ° d ONLN drŸÂ1 )ough R` ° d ONLN dwŸ1Â7 )5 R` ° d ONLN dxŸ7Â< ): ° d ONLN d{ËÙ (Ò0 ° d ONLN d|ËÙD ) = Immediate ° d ONLN d☠( 1 ° d ONLN dä˜< ) = 5 minutes ° d ONLN dó (2 ° d ONLN dòA )
= 15 minutes ° d ONLN d¶! ( 3 ° d ONLN dß!A )
= 30 minutes ° d ONLN dµ$0 (-4 ° d ONLN d∂$0A )
= 60 minutes ° d ONLN dƒ3? (<5 ° d ONLN d≈3?I ) = Never sleep
. ° d ONLN d‘X Ha o (_ HSEE ALSO
. ° d ONLN d›f är ‰ +BCmGetCameraInfo ° d ONLN dÏf ‰r Ú )Z on ° d ONLN df Úr
)page ° d ONLN dıf
r )2-28 ° d ONLN d˘f r" ), ° d ONLN d˚f"rv )CmSetOwnerName ° d ONLN d fvrÑ )T on ° d ONLN d
fÑrú )page ° d ONLN dfúrØ )2-40 ° d ONLN dfØr¥ ), ° d ONLN ds ä Í (| äCmSetPictureMode ° d ONLN d(s Í ¯ )` on ° d ONLN d,s ¯ )page ° d ONLN d1s# )2-41 ° d ONLN d5s#( ), ° d ONLN d7s(| )CmSetFlashMode ° d ONLN dEs|ä )T on ° d ONLN dIsä¢ )page ° d ONLN dNs¢µ )2-42 ° d ONLN dRsµ∫ ), ° d ONLN dTÄ äå Í (â äCmSetDateAndTime ° d ONLN ddÄ Íå ¯ )` on ° d ONLN dhÄ ¯å )page ° d ONLN dmÄå# )2-39 ° d ONLN dqÄ#å( ), ° d ONLN dsÄ(å¨ )IpGetCameraColorMatrix ° d ONLN dâĨå∫ )Ñ on ° d ONLN dçÄ∫å“ )page ° d ONLN díÄ“å )4-16 ° d ONLN dñÄÂåÍ ), ° d ONLN dòç äô (ñ äIpSetCameraColorMatrix ° d ONLN dÆçô )Ñ on ° d ONLN d≤ç ô4 )page ° d ONLN d∑ç4ôG )4-17 ° d ONLN dªçGôL ), ° d ONLN dΩçLô÷ )IpInitCameraColorMatrix ° d ONLN d‘ç÷ô‰ )ä on ° d ONLN dÿö ä¶ ¢ (£ äpage ° d ONLN d›ö ¢¶ µ )4-17 ° d ONLN d·ö µ¶ ∫ ), ° d ONLN d„ö ∫¶> )IpCalculateColorTables ° d ONLN d˘ö>¶L )Ñ on ° d ONLN d˝öL¶d )page ° d ONLN död¶r )4-9 ° d ONLN dör¶t ) ˇ† @ ˇ ˇˇˇˇ @
CmPictureInfo ° d ONLN d { Œ á ‹ )N str l ° d ONLN d $ { ‹ á Ú )uctur >` ° d ONLN d ) { Ú á )e pr ¿ ° d ONLN d - { áá ) ovides details about a specifi ¿ ° d ONLN d K {á á√ )Ñ
ed image stor „ ° d ONLN d X {¬ áÏ );
ed in the . ° d ONLN d b à l î ı ( ë l internal memory of the QuickT @ ° d ONLN d à ı îh )âake 100 camera. Images ar h¿ ° d ONLN d ò àh îã )se specifi Ä ° d ONLN d ° àå î¡ )$ ed by pictur Ö‡ ° d ONLN d ≠ à¡ îÌ )5 e number . ° d ONLN d ∂ ï l ° â ( û lin the ° d ONLN d Ω ï â ° ø ) pictureNo ° d ONLN d Δ ï ø ° )6 parameter of the ° d ONLN d ÿ ï °p )QCmGetPictureInfo ° d ONLN d Ë ïp °õ )` function. ° d ONLN d Ù Æ l ∫ “ ( ∑ ltypedef struct { ° d ONLN d º ~ » “ +unsigned short ° d ONLN d º Í »& )l
pictureNo; ° d ONLN d' ~ ÷ Ã ( ” ~
unsigned long ° d ONLN d: Í ÷> )limageDataSize; ° d ONLN dJ ÿ ~ ‰ “ ( · ~unsigned short ° d ONLN d^ ÿ Í ‰ )lwidth; ° d ONLN df Ê ~ Ú “ ( Ô ~unsigned short ° d ONLN dz Ê Í Ú )lheight; ° d ONLN dÉ Ù ~ Ã ( ˝ ~
CmDateAndTime ° d ONLN dñ Ù Í 2 )l dateAndTime; ° d ONLN d§ ~ Ã ( ~
unsigned char ° d ONLN d∑ Í& )l
flashMode; ° d ONLN d√ ~ “ ( ~unsigned short ° d ONLN d◊ Í 8 )l
exposureTime; ° d ONLN dÊ ~* “ (' ~unsigned short ° d ONLN d˙ Í* )lFNumber; ° d ONLN d, ~8 Ã (5 ~
unsigned char ° d ONLN d, Í82 )l pictureMode; ° d ONLN d%: ~F Ã (C ~
unsigned char ° d ONLN d8: ÍFb )ldataCompressionMode; ° d ONLN dNH ~T Ã (Q ~
unsigned char ° d ONLN daH ÍT> )ldefectiveFlag; ° d ONLN dpV lb> (_ l#} CmPictureInfo, *CmPictureInfoPtr;
p *¯ 4p *~¯
. ° d ONLN dîo lz ∏ *Field descriptions
ˇ·ˇ‚7^
. ° d ONLN dß| là ¢ * pictureNo . ° d ONLN d±| ‰à )x
The pictur % ° d ONLN dª|à< ).e number °† ° d ONLN d√|;à€ ))%. This value is the second parameter . ° d ONLN dËà ‰î" (ë ‰passed to the ° d ONLN dˆà"îÇ )>CmGetPictureInfo ° d ONLN dàÇî◊ )` function, which is . ° d ONLN dî ‰† (ù ‰
described on °Ä ° d ONLN d'î †6 );page |` ° d ONLN d,î7†I )2-29 –@ ° d ONLN d0îI†N ). . ° d ONLN d3£ lØ ∫ (¨ l
imageDataSize . ° d ONLN dA£ ‰Øä )x&Size of the image in number of bytes. . ° d ONLN dh≤ læ ä (ª lwidth . ° d ONLN dn≤ ‰æ Ó )xW Û` ° d ONLN do≤ Ìæï ) 'idth of the image in number of pixels. . ° d ONLN dó¡ lÕ ê ( lheight . ° d ONLN dû¡ ‰Õô )x)Height of the image in number of pixels. . ° d ONLN d»– l‹ Æ (Ÿ l dateAndTime . ° d ONLN d‘– ‰‹ó )x'Date and time that the image was captur ‹@ ° d ONLN d˚–ó‹¶ )≥ed. . ° d ONLN d fl lÎ ¢ (Ë l flashMode . ° d ONLN d
fl ‰Î Î )xA ∫† ° d ONLN d fl ÎÎí )& value indicating whether or not the fl ‡ ° d ONLN d2flíÎœ )ß
ash was used: . ° d ONLN d@Î ‰˜ Í (Ù ‰0 ° d ONLN dAΠ͘5 ) = Flash not used ° d ONLN dS˜ ‰ Í ( ‰1 ° d ONLN dT˜ Í9 ) = Flash was used ° d ONLN df l ¥ ( l exposureTime . ° d ONLN ds ‰B )xIndicates the exposur Ω† ° d ONLN dàBã )^e time that was r ˛¿ ° d ONLN dô㢠)Iequir ° d ONLN dû£· )ed to take the . ° d ONLN d≠ ‰ ( ‰specifi ° d ONLN d¥ * ) ed pictur R` ° d ONLN dΩ* < )(e. V g` ° d ONLN d¡; [ )alue is g` ° d ONLN d…[ i ) (1/ g` ° d ONLN dÃi ± ) exposureTime g` ° d ONLN dÿ± › )H ) seconds. ° d ONLN d‰! l- ñ (* lFNumber . ° d ONLN dÏ! ‰-Ù )x@The focal length of the lens of the camera, the diameter of the ° d ONLN d,- ‰9_ * lens, and the shutter speed. . ° d ONLN dJ< lH Æ (E l pictureMode . ° d ONLN dV< ‰H1 )xSize of the image: . ° d ONLN diH ‰T * 16 ° d ONLN dkH T ) = High-r R` ° d ONLN dtHTd )+esolution image ° d ONLN dÖT ‰` (] ‰32 ° d ONLN dáT ` )
= Standar R` ° d ONLN dëT `- )/d-r $¿ ° d ONLN dîT-`v )esolution image ° d ONLN d•c lo fi (l ldataCompressionMode . ° d ONLN dπc ‰o )x
Data compr ÄÄ ° d ONLN d√coZ )4ession method: . ° d ONLN d“o ‰{ Í (x ‰1 ° d ONLN d”o Í{ Ù ) = !† ° d ONLN d÷o Ù{o )
ADPCM high- and standar Ù ° d ONLN dÌon{| )zd-r Δ` ° d ONLN do|{« )esolution images ° d ONLN d{ ‰á Í (Ñ ‰3 ° d ONLN d{ Íá… )3 = Bit shift (4 bits to the right) thumbnail images ° d ONLN d6ä lñ ∫ (ì l
defectiveFlag . ° d ONLN dDä ‰ñÇ )x%Indicates a defect in the image data: . ° d ONLN djñ ‰¢ Í * 1 ° d ONLN dkñ Í¢$ )
= One or mor R` ° d ONLN dxñ$¢} ):e bad blocks of data ° d ONLN dç¢ ‰Æ Í (´ ‰0 ° d ONLN dé¢ ÍÆ= ) = Image is not corr l ° d ONLN d¢¢=ÆW )Supted ˇñ @ ˇ ˇˇˇˇ @
. ° d ONLN d j ä v Í +BCmGetPictureInfo ° d ONLN d j Í v ¯ )` on ° d ONLN d j ¯ v )page ° d ONLN d " j v# )2-29 ° d ONLN d & j# v% )
¶ H Ø 4 ß H Æ ® H ®
ˇ·ˇ‚7^
. ° d ONLN d ( ô H ß û ( £ H
CmColorMatrix ˇˇˇˇˇˇ ( £2
. ° d ONLN d 7 ∏ ä ƒ û ( ¡ äThe ° d ONLN d ; ∏ û ƒ Ï )
CmColorMatrix ° d ONLN d H ∏ Ï ƒ )N data str l ° d ONLN d Q ∏ ƒ( )&uctur >` ° d ONLN d V ∏( ƒC )e is pr ¿ ° d ONLN d ] ∏C ƒ‰ )$ovided for interface to the Image Pr „ ° d ONLN d Å ∏„ ƒ )† ocessing . ° d ONLN d ä ≈ ä —Ÿ ( Œ äJModule to facilitate decoding of the image format employed by the camera. . ° d ONLN d ’ fi ä Í Í *typedef struct { ° d ONLN d Á Ï ú ¯t +$unsigned char colorMatrixVersion[4]; ° d ONLN d
parameter ¬† ° d ONLN d◊:±F )1. This is the same ° d ONLN dÍFRC (Ovalue that is r R` ° d ONLN d˘FCRÑ )Aeturned in the R` ° d ONLN dFÑR )AcolorMatrixVersion R` ° d ONLN dFR˘ )l fi R` ° d ONLN d F˘R ) eld of ° d ONLN d$R^ ([the ° d ONLN d(R^\ ) CmCameraInfo ° d ONLN d4R\^Ç )H data str l ° d ONLN d=RÇ^ò )&uctur >` ° d ONLN dBRò^¢ )e. ° d ONLN dFa äm (j äcolorCorrectionMatrix . ° d ONLN d\my? +x The color corr ` ° d ONLN djm@y )>*ection matrix. See the description of the . ° d ONLN dîyÖ\ (ÇCharacteristics ° d ONLN d£y\Öj )Z str l ° d ONLN dßyjÖÄ )uctur >` ° d ONLN d¨yÄÖì )e on >` ° d ONLN d±yìÖ´ )page >` ° d ONLN d∂y´Öπ )4-6 >` ° d ONLN dπyπÖæ ).
. ° d ONLN dºü H® o (¶ HSEE ALSO
. ° d ONLN d≈¨ ä∏& +BCmGetColorCorrectionMatrix ° d ONLN dfl¨&∏4 )ú on ° d ONLN d„¨4∏L )page ° d ONLN d˨L∏_ )2-46 ° d ONLN dϨ_∏a )
 HÌ 4 HÏ Á HÁ
ˇ·ˇ‚7^
. ° d ONLN dÓ’ H v (· HQuickT MÄ ° d ONLN dÙ’ uÂ= )- ake 100 Device Driver Functions ˇˇˇˇˇˇ (·2
° d ONLN dÒ ä˝ — (˙ äThis section defi r ° d ONLN d&Ò “˝ß )H0nes all of the functions supported by the QuickT Ÿ¿ ° d ONLN dVÒ¶˝ )‘ake 100 device driver ¸@ ° d ONLN dkÒ˝ )]. ° d ONLN dm˛ ä
æ ( ä
The QuickT º@ ° d ONLN dw˛ Ω
S )3"ake 100 device driver functions pr ÆÄ ° d ONLN dô˛S
º )ñovide Macintosh and W fi ° d ONLN dÆ˛º
)iindows application ° d ONLN d¡ ä ( ä developers with a means to contr $ ° d ONLN d· Y )ì
ol the QuickT _¿ ° d ONLN dÓ X˚ );%ake 100 digital camera, gather image ° d ONLN d ä$ » (! äinformation fr ‘@ ° d ONLN d! »$V )> om the camera, and set any user  ° d ONLN d@V$j )é-defi + ° d ONLN dEk$Î ) nable parameters via softwar w` ° d ONLN daÎ$˙ )Äe. T v¿ ° d ONLN de˙$ )o use ° d ONLN dk% ä1U (. ä,the functions, you must include the CmDriver ìÄ ° d ONLN dó%U1e )À.h fi q† ° d ONLN dú%f1Û )"le in the include section of your ° d ONLN dæ2 ä>0 (; ä$Macintosh application code or the QT l@ ° d ONLN d‚20>c )¶ AKE-D.H fi † ° d ONLN dÏ2d>á )4le for W ‚ ° d ONLN dÙ2Ü>˜ )"indows application code. ° d ONLN dD äP — (M äThe functions ar L ° d ONLN d D “P )He divided into gr Ô@ ° d ONLN d/DP3 )Ioups: ,
Zapf Dingbats
° d ONLN d5Z äa è (` än
° d ONLN d7W ñc
) XDriver initialization functions. The functions in this category allocate and deallocate ° d ONLN dèc ño ∑ * data str º ° d ONLN dóc ∑o Œ )!uctur B ° d ONLN dúc œoJ ) es used by the device driver 0 ° d ONLN d∏cJoO ){.
° d ONLN dªx ä è (~ än
° d ONLN dΩu ñÅ™ ) >Camera connection functions. The functions in this category ar Ë ° d ONLN d˚u™Å¯ (~™e used to set up a ° d ONLN dÅ ñç (ä ñconnection with a camera.
° d ONLN d(ñ äù è (ú än
° d ONLN d*ì ñü “ ) Camera contr e¿ ° d ONLN d6ì “üq )<&ol functions. The functions in this gr ‹‡ ° d ONLN d\ìqüç )üoup ar †† ° d ONLN dbìéüº ) e used to r ê† ° d ONLN dmìºü˜ ).etrieve or set ° d ONLN d|ü ñ´7 (® ñ%various characteristics of the QuickT † ° d ONLN d°ü7´ )°-ake 100 camera (for example, the owner name). ˇ∂ @ ˇ ˇˇˇˇ @
° d ONLN d \ x h ô ) Image r P@ ° d ONLN d \ ö h Ì )"etrieval and captur ˝Ä ° d ONLN d \ Ì hâ )S%e functions. The functions in this gr ‡` ° d ONLN d A \â h• )úoup ar § ° d ONLN d G \¶ h‘ ) e used to r î ° d ONLN d R \‘ hÙ ).etrieve ° d ONLN d Z h x t ° ( q x images fr k ° d ONLN d c h ° t' )) om the camera and take pictur ‡ ° d ONLN d Ä h( t6 )áes.
Å * è¯ 4 Ç * è¯
° d ONLN d Ö Ä l ã ( à lNote
ˇ·ˇ‚7^
° d ONLN d ä ç l ô ≥ *The numeric err ~` ° d ONLN d ô ç ≥ ô ‰ )G or codes pr µ¿ ° d ONLN d § ç ‰ ô† )1+ovided in the Result Codes section of each ° d ONLN d œ ô l • – ( ¢ lfunction description ar 4† ° d ONLN d Ê ô — •ï )e-e applicable to only Macintosh applications. ° d ONLN d • l ± Ñ ( Æ lWher ‡ ° d ONLN d • Ñ ± ó )e err ™‡ ° d ONLN d • ò ±4 )!ors apply to both Macintosh and W ZÄ ° d ONLN d= •4 ±x )úindows softwar @ ° d ONLN dK •y ±ì )Ee, the ° d ONLN dR ± l Ω À ( ∫ lsymbolic constants ar ™Ä ° d ONLN dg ± À Ω ÷ )_e r π ° d ONLN dj ± ÷ Ω ) eturned to W †‡ ° d ONLN dv ± Ωk ):indows applications.
. ° d ONLN d» Ë l Ù ˝ ( Ò l!The functions in this category ar R` ° d ONLN dÈ Ë ˝ Ù )ëe ,
Courier R` ° d ONLN dÎ Ë ÙL ) CmOpenDriver R` ° d ONLN d˜ ËL Ù_ )H and R` ° d ONLN d˚ Ë_ Ùa ) R` ° d ONLN d¸ Ëa ÙØ )
CmCloseDriver ï ° d ONLN d ËÆ Ù– )M. These . ° d ONLN d ı lB ( ˛ l2functions allocate and deallocate private data str n@ ° d ONLN dC ıBY )÷uctur Ù ° d ONLN dH ıYh )es r ?¿ ° d ONLN dL ıiÄ )equir W ° d ONLN dQ ıÄÃ )ed by the QuickT ± ° d ONLN da ıÀÓ )Kake 100 ° d ONLN di l á ( ldriver ‡ ° d ONLN do á å ).
> *G¯ 4? *F¯ @ *@˛
ˇ·ˇ‚7^
° d ONLN dr1 *? (; * CmOpenDriver ˇˇˇˇˇˇ (;Ú2
. ° d ONLN dÄP l\§ (Y l4pascal OSErr CmOpenDriver(CameraDataPtr cameraData); ° d ONLN dµh lt ® *
cameraData . ° d ONLN d¿h Æte )B+Pointer to the private data allocated and r J† ° d ONLN dÎhft )∏eturned by the QuickT {¿ ° d ONLN d h…tÏ )cake 100 ° d ONLN dt ÆÄ Ë (} Æ
device driver I¿ ° d ONLN dt ËÄœ ):5. This pointer must be passed to all the other QuickT Ä ° d ONLN dJtŒÄÒ )Êake 100 ° d ONLN dRÄ Æå (â Ædriver functions as the fi K† ° d ONLN dlÄåU )l
rst parameter @ ° d ONLN dyÄUåZ );. ° d ONLN d}ê Æú … (ô ÆFor W j† ° d ONLN dÇê …ú )indows: the addr £Ä ° d ONLN díêúœ )K+ess of a memory location that contains the ° d ONLN dΩú Æ® Ú (• Æapplication ID. . ° d ONLN dœ¨ Æ∏ ¿ *See ° d ONLN d”¨ ¿∏ ) “CameraData” ° d ONLN dfl¨∏ )F on ° d ONLN d„¨∏, )page ° d ONLN d˨,∏: )2-8 ° d ONLN dΨ:∏\ ) for mor R` ° d ONLN dÛ¨\∏∂ )"e information about R` ° d ONLN d¨∂∏Ú )Z
cameraData R` ° d ONLN d¨Ú∏ı )<.
. ° d ONLN d“ *€ c (Ÿ * DESCRIPTION
. ° d ONLN d ‡ lÏ Ä +BThe ° d ONLN d#‡ ÄÏ » ) CmOpenDriver ° d ONLN d/‡ »ÏÙ )HE function initializes the driver by allocating and then initializing . ° d ONLN dtÌ l˘ ≠ (ˆ lcertain data str d¿ ° d ONLN dÑÌ Æ˘ ≈ )Buctur ͆ ° d ONLN dâÌ ≈˘∑ )8es that the driver uses upon subsequent function calls.
*¯ 4 *¯
° d ONLN d¬ l ( lNote
ˇ·ˇ‚7^
° d ONLN d« l £ *GDuring initialization on the Macintosh platform, application globals ar k† ° d ONLN d£ ™ ( £e . ° d ONLN d l+ ¬ (( lsaved via a call to ° d ONLN d$ ¬+
° d ONLN d;ô l° ã (ü lIMPORT Ä ° d ONLN dAô ã° õ ) ANT
ˇ·ˇ‚7^
. ° d ONLN dE§ l∞ ë (≠ lCalling ° d ONLN dM§ ë∞ Ÿ )% CmOpenDriver ° d ONLN dY§ Ÿ∞≠ )H2 after the driver is open without a prior call to ° d ONLN dã∞ lº ∫ (π l
CmCloseDriver ° d ONLN dò∞ ∫º ÷ )N will r R` ° d ONLN dü∞ ÷º ) esult in an err $¿ ° d ONLN dÆ∞º )=or g` ° d ONLN d∞∞º ).
)6ed ° d ONLN dm b (b"Library Manager or GeoPort system ° d ONLN dèb õ *
extensions ar =‡ ° d ONLN dúú » ):
e missing. . ° d ONLN dß ä+ Δ (( ä
memFullErr . , ° d ONLN d≤ 8+J )Æ-108 ° d ONLN d∑ b+¿ )*Macintosh system err O‡ ° d ONLN dÀ ¡+ )_or: Not enough ° d ONLN d⁄*b6ù (3b memory for r i‡ ° d ONLN dÊ*ù6ˆ );equested operation. ˇˇ’ö . ° d ONLN d˚: äF · (C äFor the Macintosh, ˇˇÄŒ Œ ° d ONLN d: ‚FT )XkCmAlreadyOpenError ˇˇ’ö Œ ° d ONLN d!:TFx )r
is also r S¸ ° d ONLN d+:xF )$#eturned if another application has . ° d ONLN dNG äS ï (P äalr -` ° d ONLN dQG ñS ) eady opened the QuickT ˜¿ ° d ONLN dgGS? )kake 100 driver Ï` ° d ONLN duG?SD )>.
° d ONLN dxm Hv o (t HSEE ALSO
. ° d ONLN dÅ{ äá ÿ +B
CmCloseDriver ¬† ° d ONLN dé{ ◊á )M, described next
∑ H¿ 4∏ Hø π Hπ
ˇ·ˇ‚7^
. ° d ONLN d†™ H∏ ù (¥ H
CmCloseDriver ˇˇˇˇˇˇ (¥2
. ° d ONLN dØ… ä’∂ (“ ä2pascal OSErr CmCloseDriver(CameraData cameraData); ° d ONLN d‚· äÌ Δ *
cameraData ° d ONLN dÌ· ÃÌ) )BThe private data str l ° d ONLN d·)Ì? )]uctur >` ° d ONLN d·?ÌJ )e r ¿ ° d ONLN d ·JÌ{ ) eturned by ¿ ° d ONLN d·{Ì√ )1 CmOpenDriver ¿ ° d ONLN d ·√̈ )H when your . ° d ONLN d+Ì Ã˘N (ˆ à application opens the QuickT ‰` ° d ONLN dGÌM˘™ )Åake 100 device driver ‡ ° d ONLN d\Ì´˘∞ )^.
° d ONLN d_ H Å ( H DESCRIPTION
° d ONLN dk ä, Œ +BThis function fr æ† ° d ONLN d{ Œ, )Dees the internal str º` ° d ONLN dè ,6 )Quctur B@ ° d ONLN dî 7,s )es implicitly r ؆ ° d ONLN d£ s,É )<efer [¿ ° d ONLN dß Ñ,Í )enced by the functions. . ° d ONLN dø- ä9 ë (6 äY ï ° d ONLN d¿- ê9
) our application should call ï ° d ONLN d‹-
9[ )}
CmCloseDriver ï ° d ONLN dÈ-[9î )N once when fi ï ° d ONLN dˆ-î9 )9nished with the QuickT ™ ° d ONLN d - 9 )lake . ° d ONLN d: äF` (C ä2100 device driver and after it has disconnected fr D ° d ONLN dB:aF
)◊%om any camera with which it has been ° d ONLN dgG äS º (P ä interacting.
. ° d ONLN d~m äy Ø (v äCalling ° d ONLN dÜm Øy ˝ )%
CmCloseDriver ° d ONLN dìm ˝y8 )N
without a pr R` ° d ONLN d†m8yv );evious call to R` ° d ONLN dØmvyæ )> CmOpenDriver R` ° d ONLN dªmæy¿ )H ° d ONLN dºy äÖ § (Ç äwill r R` ° d ONLN d¬y §Ö œ ) esult in a R` ° d ONLN dÕy œÖ) )+kCmNotOpenError R` ° d ONLN d‹y)Ö8 )Z err $¿ ° d ONLN d‡y8ÖA )or g` ° d ONLN d‚y@ÖE ). ° d ONLN d‰yEÖM )A |` ° d ONLN dÂyLÖm ) call to |` ° d ONLN dÓymÖª )!
CmCloseDriver |` ° d ONLN d˚yªÖΩ )N ° d ONLN d¸Ö äë (é ämade prior to a call to ° d ONLN dÖ ë8 )f CmDisconnect ° d ONLN d Ö8ë∫ )H will not close the connection ° d ONLN d?ë äù Ú (ö äwith the camera. Call ° d ONLN dUë Úù: )h CmDisconnect ° d ONLN daë:ùS )H befor R` ° d ONLN dgëSùZ )e R` ° d ONLN diëZù® )
. ° d ONLN d6Æ l∫í (∑ l1pascal OSErr CmGetPortInfo(CameraData cameraData, ° d ONLN doº Í»b +~unsigned long index, ° d ONLN dã Í÷» *%CmPortInfoHandlePtr portInfoHandle); ° d ONLN d±‚ lÓ ® (Î l
cameraData ° d ONLN dº‚ ÆÓ )BThe private data str l ° d ONLN d–‚ Ó! )]uctur >` ° d ONLN d’‚!Ó, )e r ¿ ° d ONLN dÿ‚,Ó] ) eturned by ¿ ° d ONLN d„‚]Ó• )1 CmOpenDriver ¿ ° d ONLN dÔ‚•Óÿ )H when your . ° d ONLN d˙Ó Æ˙0 (˜ Æ application opens the QuickT ‰` ° d ONLN dÓ/˙å )Åake 100 device driver ‡ ° d ONLN d+Óç˙í )^. . ° d ONLN d.˛ l
ä ( lindex . ° d ONLN d4˛ Æ
1 )B Index number of a serial port: ° d ONLN dS
Æ · * Macintosh: ° d ONLN d`
È0 );1 = Modem port ° d ONLN dq È", * 2 = Printer port ° d ONLN dÇ" Æ. ∏ (+ ÆW Û` ° d ONLN dÉ" ∑. ⁄ ) indows: ° d ONLN då" È. ˝ )21 thr ÿ¿ ° d ONLN dë" ˝.b )ough 9 for Comm 1 thr ˇ ° d ONLN d¶"b.™ )eough Comm 9, r ’¿ ° d ONLN d¥"™.€ )H espectively . ° d ONLN d¿2 l> ¿ (; lportInfoHandle ° d ONLN dœ> ÆJ Δ +B Addr R` ° d ONLN d”> ΔJ± )4ess of a memory location into which the handle of a R` ° d ONLN d>±JÌ )Î
CmPortInfo R` ° d ONLN d>ÌJÔ )< . ° d ONLN dJ ÆV œ (S Ædata str º ° d ONLN dJ œV Ê )!uctur B ° d ONLN d J ÁV )e is to be stor Ù ° d ONLN d.J V/ )9ed.
° d ONLN d3p *y c (w * DESCRIPTION
ˇ˛˜| . ° d ONLN d?} lâ ∫ +B
CmGetPortInfo ˇˇß‘ ° d ONLN dL} ∫â
)N determines the pr I‹ ° d ONLN d^} ⯠)Q6esence and the availability of a camera at the end of . ° d ONLN dîä lñ (ì l"a serial port on the host computer Â` ° d ONLN d∂ä ñ )î. ˇ!í @ ˇ ˇˇˇˇ @
, (‡2-23 4 ^ H¿ ° d ONLN d \ ä h à ( e äThe driver defi á ° d ONLN d \ à h¨ )B0nes each serial communication port with a number † ° d ONLN d ? \¨ hÛ )‡. The number is . ° d ONLN d O i ä u ( r ä!supplied to this function as the ,
Courier ° d ONLN d p i u6 )éindex ° d ONLN d u i6 u™ ) parameter and is used by ° d ONLN d è i™ u¯ )t
CmGetPortInfo ° d ONLN d ú i¯ u )N to . ° d ONLN d † v ä Ç™ ( äCindex into the array of serial ports available on the host computer ßÄ ° d ONLN d „ v™ ÇØ ( ™. . ° d ONLN d Ê à ä îU ( ë ä/The output of this function is a handle to the ° d ONLN d àU îë )À
CmPortInfo ° d ONLN d àë î∑ )< data str l ° d ONLN d( à∑ îÕ )&uctur >` ° d ONLN d- àÕ î )e that contains, . ° d ONLN d> ï ä °⁄ ( û äIamong other things, information as to whether the communication port corr S@ ° d ONLN dá ï⁄ ° ( û⁄
esponding ° d ONLN dë ¢ ä Æ ( ´ äUto the given index number has a camera attached and, if it has, whether the attached ° d ONLN dÊ Ø ä ª1 *
'camera is available for use by the curr √` ° d ONLN d
Ø1 ªÏ )ß+ent application. For information about the . ° d ONLN d8 º ä » Δ ( ≈ ä
CmPortInfo ° d ONLN dB º Δ » Ï )< data str l ° d ONLN dK º Ï » )&uctur >` ° d ONLN dP º » )e, see >` ° d ONLN dW º »4 )page >` ° d ONLN d\ º4 »G )2-10 >` ° d ONLN d` ºG »J ). ° d ONLN db Œ ä ⁄ ¢ ( ◊ äThe r R` ° d ONLN dg Œ ¢ ⁄ )ecommended way to use the R` ° d ONLN dÅ Œ ⁄n )~
CmGetPortInfo R` ° d ONLN dé Œn ⁄ )N( function is to call it multiple times, ° d ONLN d∂ € ä Á õ ( ‰ äincr R` ° d ONLN d∫ € õ Á ÿ )
ementing the R` ° d ONLN d« € ÿ Á ˆ )=index R` ° d ONLN dà € ˆ Áë ) $ parameter by 1 for each call until R` ° d ONLN d €ë Á˝ )õkCmNoSuchPortError R` ° d ONLN d €˝ Á )l is ° d ONLN d Ë ä Ù é ( Ò är R` ° d ONLN d Ë é Ù € )eturned on the W ≈¿ ° d ONLN d Ë ⁄ Ù5 )Lindows platform, or ≈¿ ° d ONLN d+ Ë5 Ùq )[
kNoPortErr ≈¿ ° d ONLN d5 Ëq ÙÅ )< is r ò ° d ONLN d: ËÅ Ùı )eturned on the Macintosh . ° d ONLN dS ı ä µ ( ˛ ä
platform. @ ° d ONLN d] ı ∂ º ),Y œ¿ ° d ONLN d^ ı ªP )!our application code should be pr ËÄ ° d ONLN d ıPc )ïepar y@ ° d ONLN dÉ ıd )(ed to deal with a situation in which it ° d ONLN d´ ä » ( ä
discovers mor ‘‡ ° d ONLN d∏ »† )>1e than one available camera during the calling pr “ ° d ONLN dȆ )ÿocess. For example, you ° d ONLN d ä ≥ ( äwould pr û‡ ° d ONLN d ≥ ))Movide a dialog box that allows the user to choose the camera with which they ° d ONLN dV ä( (% ä!would like to make a connection. . ° d ONLN dx. ä: fi *The handle to the ° d ONLN dä. fi: )T
CmPortInfo ° d ONLN dî.:( )< str l ° d ONLN dò.(:> )uctur >` ° d ONLN dù.>:I )e r ¿ ° d ONLN d†.I:Ù ) (eturned by this function is supplied to ° d ONLN d»; äG ¿ (D ä CmConnect ° d ONLN d—; ¿G Δ )6 i ° d ONLN d”; ΔG fl )n the ° d ONLN dŸ; flG3 )portInfoHandle ° d ONLN dÁ;3G )T- parameter when you want your application to . ° d ONLN dH äT+ (Q ä#make a connection with the camera. . ° d ONLN d8Z äf *The value contained in the ° d ONLN dSZfA ){
portStatus ° d ONLN d]ZAfJ )< fi ° d ONLN d`ZJfx ) eld of the ° d ONLN dkZxf¥ ).
CmPortInfo ° d ONLN duZ¥f¬ )< str l ° d ONLN dyZ¬fÿ )uctur >` ° d ONLN d~Zÿf )
e must be . ° d ONLN dàg äs Œ (p äexamined befor E ° d ONLN dñg œsı )ECe a connection is actually made with the camera. The values in the . ° d ONLN dŸt äÄ Δ (} ä
portStatus ° d ONLN d„t ΔÄ Ã )< f PÄ ° d ONLN dÂt ÃÄ' )ield apply to the W √‡ ° d ONLN d¯t&ÄÌ )Z*indows and Macintosh platforms as follows: ˇˇff ° d ONLN d#Ü äí ∏ (è ä
ently not . ° d ONLN dÀà äÿ (’ ä connected, the value in the ° d ONLN dÁÃÿ; ){ DataSpeed ° d ONLN dÃ;ÿD )6 fi ° d ONLN dÛÃDÿr ) eld of the ° d ONLN d˛ÃrÿÆ ).
CmPortInfo ° d ONLN dÃÆÿº )< str l ° d ONLN d úÿ“ )uctur >` ° d ONLN dÓÿ› )e r ¿ ° d ONLN dÛÿ ) eturned by . ° d ONLN d Ÿ ä (‚ ä\this function is 0. This is because the actual data transfer rate is not determined until a . ° d ONLN d{Ê äÚ ÷ *
successful call to ° d ONLN déÊ ÷Ú )L CmConnect ° d ONLN dóÊ Úk )6 has been completed. !† ° d ONLN d¨ÊkÚ )_'After a successful connection is made, ° d ONLN d”Û äˇ ú (¸ äthe ° d ONLN d◊Û úˇ “ ) DataSpeed ° d ONLN d‡Û “ˇ € )6 fi ° d ONLN d„Û €ˇ ) eld in the ° d ONLN dÓÛ ˇE ).
CmPortInfo ° d ONLN d¯ÛEˇS )< str l ° d ONLN d¸ÛSˇi )uctur >` ° d ONLN d Ûiˇfi )e is updated with the corr ¿ ° d ONLN d Ûfiˇ )u ect data . ° d ONLN d $ ä ƒ ( ätransfer rate.
Œs ±N )'&esponsibility of the application to fr û@ ° d ONLN d
ÙsNõ )ùee the memory ar º¿ ° d ONLN d sõß )Mea ˇˇ„é . ° d ONLN d äã@ (à ä*allocated by this function by calling the ˇˇ™™ ∏‚ ° d ONLN d 1@㶠)∂CmDisposePortInfo ˇˇ„é ∏‚ ° d ONLN d B¶ãÕ )f
function . ° d ONLN d Lã äó ˆ (î äto dispose of the data str ⁄ ° d ONLN d fã ˆó
° d ONLN d \ * e D ( c *RESUL ëÄ ° d ONLN d \ D e h )T CODES
. ° d ONLN d
j l v Í +( Upon successful completion, ,
Courier ° d ONLN d ) j Í v8 )~
CmGetPortInfo ° d ONLN d 6 j8 v> )N r R` ° d ONLN d 8 j> v[ )eturns R` ° d ONLN d ? j[ vy ) noErr ï ° d ONLN d D jx v¢ )
, and the ° d ONLN d N w l É ¿ ( Ä lportInfoHandle ° d ONLN d \ w ¿ ÉÂ )TB parameter supplied to this function contains a valid handle of a ° d ONLN d û Ñ l ê ® ( ç l
otocol err K` ° d ONLN døAxMÏ )*or during communication ° d ONLN d◊LDXå (UDwith the QuickT ± ° d ONLN dÊLãX” )Gake 100 camera. ° d ONLN dˆWDcN (`DW Û` ° d ONLN d˜WMc≠ ) indows platform only 1‡ ° d ONLN d W≠cØ )`. . ° d ONLN d
esponding ° d ONLN d;mDy‚ (vD#communication port does not exist. ° d ONLN d^xDѱ * Macintosh platform only E ° d ONLN dux±Ñ≥ )m. . ° d ONLN dwÉ lè ú (å lparamErr . , ° d ONLN dÄÉ è, )≥-50 ° d ONLN dÑÉDè“ )% Parameter is invalid. Macintosh ° d ONLN d§éDöÄ *
platform only _Ä ° d ONLN d±éÄöÇ )<.
° d ONLN d≥≤ *ª Q (π *SEE ALSO
. ° d ONLN dº¿ là “ +BCmDisposePortInfo ° d ONLN dÕ¿ “à )f described next; ° d ONLN dfi¿ÃO )G CmConnect ° d ONLN dÁ¿OÃ] )6 on ° d ONLN dο]Ãu )page ° d ONLN d¿uÃà )2-25 ° d ONLN dÙ¿àÃä )
¸ *¯ 4˝ *¯ ˛ *˛˛
ˇ·ˇ‚7^
. ° d ONLN dˆÔ *˝ ó (˘ *CmDisposePortInfo ˇˇˇˇˇˇ (˘Ú2
. ° d ONLN d l∞ ( l6pascal OSErr CmDisposePortInfo(CameraData cameraData, ° d ONLN dH ¸(» +ê"CmPortInfoHandle portInfoHandle); ° d ONLN dk4 l@ ® (= l
. ° d ONLN d Ñ è ä õ ( ò ä!Applications must dispose of the ° d ONLN d • è õ\ )ñ
CmPortInfo ° d ONLN d Ø è\ õÇ )< data str l ° d ONLN d ∏ èÇ õò )&uctur >` ° d ONLN d Ω èò õ£ )e r ¿ ° d ONLN d ¿ è£ õ« ) eturned ° d ONLN d » õ ä ß ó ( § äby ° d ONLN d À õ ó ß Â )
CmGetPortInfo ° d ONLN d ÿ õ Â ß )N
with the ° d ONLN d ‚ õ ßx )-CmDisposePortInfo ° d ONLN d Û õx ß∑ )f function befor R` ° d ONLN d õ∑ ßæ )?e ° d ONLN d ß ä ≥ ’ ( ∞ ämaking a call to ° d ONLN d ß ’ ≥# )K
CmCloseDriver ¬† ° d ONLN d" ß" ≥' )M. ,
Zapf Dingbats
. ¬† ° d ONLN d% ™, ≤3 )
s
. † ° d ONLN d& ß3 ≥5 )
. ° d ONLN d( à H ’ b ( ” HRESUL ëÄ ° d ONLN d- à b ’ Ü )T CODES
CmGetPortInfo ° d ONLN dcÉ ÿè Ê )N on ° d ONLN dgÉ Êè ˛ )page ° d ONLN dlÉ ˛è )2-22 ° d ONLN dpÉè ), ° d ONLN drÉèd )
CmCloseDriver ° d ONLN dÉdèr )N on ° d ONLN dÉÉrèä )page ° d ONLN dàÉäèù )2-21 ° d ONLN dåÉùèü )
ø H» 4¿ H« ¡ H¡
ˇ·ˇ‚7^
. ° d ONLN dé≤ H¿ ã (º H
CmConnect ˇˇˇˇˇˇ (º2
. ° d ONLN dö— ä›û (⁄ ä.pascal OSErr CmConnect(CameraData cameraData, ° d ONLN d—flÎÊ +ê"CmPortInfoHandle portInfoHandle); ° d ONLN dÙ˜ ä Δ ( ä
cameraData ° d ONLN dˇ˜ Ã) )BThe private data str l ° d ONLN d˜)? )]uctur >` ° d ONLN d˜?J )e r ¿ ° d ONLN d˜J{ ) eturned by ¿ ° d ONLN d&˜{√ )1 CmOpenDriver ¿ ° d ONLN d2˜√ˆ )H when your . ° d ONLN d= ÃN ( à application opens the QuickT ‰` ° d ONLN dYM™ )Åake 100 device driver ‡ ° d ONLN dn´∞ )^. . ° d ONLN dq ä fi ( äportInfoHandle ° d ONLN dÄ Ã+ +B Handle of a ° d ONLN då +@ )8
CmPortInfo ° d ONLN dñ @+N )< str l ° d ONLN dö N+d )uctur >` ° d ONLN dü d+ ) e that has been allocated and r ¿ ° d ONLN dæ + )åeturned ° d ONLN dΔ+ Ã7 Î (4 Ãby a pr R` ° d ONLN dÕ+ Î7) ) evious call to R` ° d ONLN d‹+)7w )>
CmGetPortInfo R` ° d ONLN dÈ+w7| )N.
. ° d ONLN dÏQ HZ Å (X H DESCRIPTION
. ° d ONLN d¯^ äj û +BThe ° d ONLN d¸^ ûj ‘ ) CmConnect ° d ONLN d^ ‘j” )6; function is used to establish a connection with a camera. !† ° d ONLN d@^”jˆ )ˇAfter a . ° d ONLN dHk äw (t ä connection is made, the QuickT † ° d ONLN dfkw¯ )ä4ake 100 device driver functions can be used to contr NÄ ° d ONLN dök˘w )Âol the ° d ONLN d°x äÑ Ø (Å äcamera. ° d ONLN d™ä äñÛ *QOn the Macintosh computer the connection is a high-speed serial connection. In a . ° d ONLN d˚ó ä£ ï *
W Û` ° d ONLN d¸ó î£ Œ )
indows envir ≈¿ ° d ONLN dó Œ£ ): onment the ≈¿ ° d ONLN dó£8 )4 CmConnect ≈¿ ° d ONLN d ó8£ )60 function determines the fastest speed at which . ° d ONLN dL§ ä∞ö (≠ ä<the host and camera can communicate and selects that speed. ˇ ∂ @ ˇ ˇˇˇˇ @
° d ONLN d ^ l f ã ( d lIMPORT Ä ° d ONLN d ^ ã f õ ) ANT
ˇ·ˇ‚7^
° d ONLN d i l us ( r l;An application can connect with only one camera at a time. . ° d ONLN d P z l Ü/ *(Although an application may allocate mor R` ° d ONLN d x z/ Ü_ )√ e than one ,
Courier R` ° d ONLN d É z_ Üõ )0
CmPortInfo R` ° d ONLN d ç zõ Üù )< ° d ONLN d é Ü l í x ( è lstr l ° d ONLN d ë Ü x í é ) uctur >` ° d ONLN d ñ Ü é í% )"e by making multiple calls to the >` ° d ONLN d ∏ Ü% ís )ó
CmGetPortInfo >` ° d ONLN d ≈ Üs í¶ )N
function, a ° d ONLN d “ í l û ( õ lkCmCurrentlyConnectedError ° d ONLN d Ï í û )ú err R` ° d ONLN d í û< ) or will r $¿ ° d ONLN d ˘ í< û≠ )%esult if that application . ° d ONLN d û l ™ ⁄ ( ß ltries to connect with mor ¬@ ° d ONLN d, û ⁄ ™/ )ne than one camera. ,
. ° d ONLN dG √ l œ î *In the W Û` ° d ONLN dO √ ì œ ÿ )'indows softwar ≈¿ ° d ONLN d] √ ÿ œ ˜ )Ee envir ò ° d ONLN dd √ ˜ œ ) onment ò ° d ONLN dk √ œO )" CmConnect ò ° d ONLN dt √O œØ )6 determines the data . ° d ONLN dâ œ l € ( ÿ l"transfer speed at which the QuickT ¥@ ° d ONLN d´ œ €Ñ )ö ake 100 camera and the host . ° d ONLN d« € l Á ¡ ( ‰ lcommunicate. Ther R` ° d ONLN dÿ € ¡ Á ” )Uefor $¿ ° d ONLN d‹ € ” Á( )e, the value in the $¿ ° d ONLN d €( Á^ )U DataSpeed $¿ ° d ONLN d˘ €^ Ág )6 fi $¿ ° d ONLN d¸ €g ÁÉ ) eld of ° d ONLN d Á l Û ¿ ( lportInfoHandle ° d ONLN d Á ¿ Û Δ )T r R` ° d ONLN d Á Δ Û0 )eturned by a call to the R` ° d ONLN d, Á0 Û~ )j
CmGetPortInfo R` ° d ONLN d9 Á~ Û∞ )N
function is ° d ONLN dF Û l ˇ ( ¸ l+not valid until after a successful call to ° d ONLN dq Û ˇS )± CmConnect ° d ONLN dz ÛS ˇX )6. . ° d ONLN d} l … (
lIf communication err ‰ ° d ONLN dë … ‚ )]ors ar Œ@ ° d ONLN dó ‚™ ).e detected during image data transfers in the ° d ONLN d≈ l v ( lW Û` ° d ONLN dΔ u Ø ) indows envir A ° d ONLN d“ ∞ † );7onment, the cause may be the transfer speed set at the ° d ONLN d l(< (% l.time the connection with the camera is made. T @ ° d ONLN d7 <(U )–o corr ≤ ° d ONLN d= U(¢ )ect this situation, ° d ONLN dQ( l4 v (1 lW Û` ° d ONLN dR( u4 Í ) indows applications can cr Ω ° d ONLN dl( Î4 )v eate an W ◊Ä ° d ONLN du(4y )+indows initialization fi “Ä ° d ONLN dç(z4ü )d le (INI fi Ò ° d ONLN dó(ü4¨ )%le) ° d ONLN dõ4 l@ ÷ (= lthat limits the upper thr `` ° d ONLN d¥4 ÷@é )j)eshold for serial communication with the ° d ONLN d›@ lL å (I lQuickT ÄÄ ° d ONLN d„@ åL ‘ ) ake 100 camera. Ÿ¿ ° d ONLN dÛ@ ‘L ÷ )H ° d ONLN dıQ l] ñ (Z l The INI fi T` ° d ONLN dˇQ ó] Ï )+le must be in the W <† ° d ONLN dQ Ï] )Uindows r `† ° d ONLN dQ]0 )'oot dir ◊ ° d ONLN d!Q0]è ) ectory and be named ˇˇMÓ . ° d ONLN d5] li z (f lQT ¬† ° d ONLN d7] yi ≥ )
AKE-D.INI. é ° d ONLN dB] ¥i Œ );The fi ^| ° d ONLN dH] ŒiB ) le must contain the section ˇ˝È ‰" ° d ONLN dd]Bi~ )t
[QTake1-D] ˇˇMÓ ‰" ° d ONLN dn]~iØ )< as follows: ° d ONLN d{n lz ® (w l
[QTake1-D] ° d ONLN dÜ{ lá ¿ *
MaxBaudRate = . ° d ONLN dî{ ¿á ” )Tnnn ° d ONLN dôç lô Ç (ñ lwher 7 ° d ONLN dùç Éô ä )e Ć ° d ONLN düç äô ö )nnn . ° d ONLN d¢ç õôK )) is a value that determines the upper thr ˇ ° d ONLN dÀçKôè )∞eshold for data ° d ONLN d€ô l• Ø (¢ ltransfer speed. „@ ° d ONLN dÎô Ø• )CAllowable values ar ‚¿ ° d ONLN d˛ô•¶ )X%e 9600, 19200, 38400, and 57600. For . ° d ONLN d#• l± w (Æ lW Û` ° d ONLN d$• v± ≠ )
indows, the Û` ° d ONLN d0• ≠± „ )7 CmConnect Û` ° d ONLN d9• „±õ )6+ function uses 57,600 as the default upper . ° d ONLN dd± lΩ y (∫ lthr X¿ ° d ONLN dg± yΩq )
8eshold when determining the data transfer speed. If a pr ° d ONLN dü±rΩ´ )˘
oblem exists ° d ONLN d¨Ω l… Œ (Δ lduring data transfer fr (‡ ° d ONLN d√Ω œ…t )c%om the camera, use a lower value for . ° d ONLN dË… l’ Æ (“ l MaxBaudRate ° d ONLN dÛ… Æ’ À )B in the ° d ONLN d˙… À’ € ) QT ¬† ° d ONLN d˝… ⁄’ )
AKE-D.INI ¬† ° d ONLN d…’ )8f ì ° d ONLN d…’& )ile.
. ì ° d ONLN d
Ã+‘1 )u
. · ° d ONLN d…1’3 )
. ° d ONLN dÓ *˜ D (ı *RESUL ëÄ ° d ONLN dÓ D˜ h )T CODES
. ° d ONLN d ¸ l Í +( Upon successful completion, ° d ONLN d9¸ Í )~ CmConnect ° d ONLN dB¸ & )6 r R` ° d ONLN dD¸&C )eturns R` ° d ONLN dK¸Ca ) noErr ï ° d ONLN dP¸`c ) . . ° d ONLN dR l è ( l If an err Ö ° d ONLN d[ è
«# )uctur >` ° d ONLN db ª# «4 )e ar ¿ ° d ONLN df ª4 « )"e other than the global constants ¿ ° d ONLN dà ª « )ñ kCmFamilyID ¿ ° d ONLN dì ª « )B ° d ONLN dî » ä ‘ ù ( — äand ° d ONLN dò » ù ‘ fl ) kCmDeviceID ° d ONLN d£ » fl ‘ Ë )B, r R` ° d ONLN d¶ » Ë ‘ ) espectively 6† ° d ONLN d± » ‘w )4. This function also r ° d ONLN d« »w ‘î )[eturns ° d ONLN dŒ ’ ä · ( fi äkCmCameraNotFoundError ° d ONLN d‰ ’ ·, )Ñ if the ° d ONLN dÏ ’, ·\ ) familyID ° d ONLN dÙ ’\ ·q )0 and ° d ONLN d˘ ’q ·° )deviceID ° d ONLN d ’° ·ß )0 f PÄ ° d ONLN d ’ß · )ields ar "‡ ° d ONLN d ’ ·Ú )#
e not corr ı@ ° d ONLN d ’Ò · )'ect. ° d ONLN d Á ä Û ¶ ( äFor W Û` ° d ONLN d Á • Û )indows applications, Û` ° d ONLN d5 Á Û< )a CmConnect Û` ° d ONLN d> Á< Ûã )6 also updates the Û` ° d ONLN dP Áã Û¡ )O dataSpeed Û` ° d ONLN dY Á¡ Û )6 fi Û` ° d ONLN d\ Á Û¯ ) eld of the ˇ˛é ° d ONLN dg Ù ä Δ ( ˝ ä
CmPortInfo ˇˇÑ∞ ° d ONLN dq Ù Δ ” )< str ∞ ° d ONLN du Ù ” È )
uctur √ ° d ONLN dz Ù È )Fe with the actual data transfer rate that has been set for subsequent . ° d ONLN d¿ ä
(
ä communication with the camera.
° d ONLN d·' H0 o (. HSEE ALSO
. ° d ONLN dÍ5 äA ÿ +B
CmGetPortInfo ° d ONLN d˜5 ÿA Ê )N on ° d ONLN d˚5 ÊA ˛ )page ° d ONLN d 5 ˛A )2-22 ° d ONLN d5A ); ° d ONLN d5A^ ) CmDisconnect ° d ONLN d5^A• )H, described next
q Hz 4r Hy s Hs
ˇ·ˇ‚7^
. ° d ONLN d$d Hr ò (n H CmDisconnect ˇˇˇˇˇˇ (n2
. ° d ONLN d2É äè∂ (å ä2pascal OSErr CmDisconnect(CameraData cameraData); ° d ONLN deõ äß Δ *
cameraData ° d ONLN dpõ Ãß) )BThe private data str l ° d ONLN dÑõ)ß? )]uctur >` ° d ONLN dâõ?ßJ )e r ¿ ° d ONLN dåõJß{ ) eturned by ¿ ° d ONLN dóõ{ß√ )1 CmOpenDriver ¿ ° d ONLN d£õ√߈ )H when your . ° d ONLN dÆß Ã≥N (∞ à application opens the QuickT ‰` ° d ONLN d ßM≥™ )Åake 100 device driver ‡ ° d ONLN dflß´≥∞ )^.
° d ONLN d‚Õ H÷ Å (‘ H DESCRIPTION
. ° d ONLN dÓ⁄ äÊ û +BThe ° d ONLN dÚ⁄ ûÊ Ê ) CmDisconnect ° d ONLN d˛⁄ ÊÊÈ )H9 function ends the connection with the camera that was pr R` ° d ONLN d7⁄ÈÊ („È eviously ° d ONLN d@Á äÛ œ ( äestablished by ° d ONLN dOÁ œÛ )E CmConnect ° d ONLN dXÁÛ
)6. ˇˇ¿ ° d ONLN d[˘ ä ( äAn application should call ˇˇ@ ° d ONLN dv˘M ){ CmDisconnect ˇˇ¿ ° d ONLN dǢM° )H whenever it has fi ° d ONLN dï˘° )Tnished interacting with a . ° d ONLN dØ ä Ø ( äcamera. " ° d ONLN d∑ Øz )%/Applications must also call this function befor :† ° d ONLN dÊz )À!e connecting with a camera other ˇˇüä . ° d ONLN d ä ( ä than the one with which ther p ° d ONLN d# 8 )Ü e is a curr ! ° d ONLN d.9 { ))ent connection. ƒ ° d ONLN d>{ ß )B
After the ˇ˛fiû @ÿ ° d ONLN dHß Ô ), CmDisconnect ˇˇüä @ÿ ° d ONLN dTÔ )H
function ° d ONLN d^ ä, ÿ () ähas successfully r R` ° d ONLN dp ÿ,œ )N6eturned, the application can then make another call to R` ° d ONLN d¶ œ,— )˜ R` ° d ONLN dß —, ) CmConnect R` ° d ONLN d∞ , )6 R` ° d ONLN d± , )to . ° d ONLN d¥- ä9G (6 ä+establish a new connection for the camera. . ° d ONLN d‡? äK û *The ° d ONLN d‰? ûK Ê ) CmDisconnect ° d ONLN d? ÊKØ )H, function terminates any outstanding asynchr R` ° d ONLN d ?ØK )…onous operation with ° d ONLN d1L äX ± (U ä
a call to ° d ONLN d;L ±X5 )'CmCancelAsyncOperation ° d ONLN dQL5X` )Ñ on the W Û` ° d ONLN dZL_X )*"indows platform. On the Macintosh ° d ONLN d|Y äe ∏ (b ä
platform, ° d ONLN dÜY ∏e Ë ).PBKillIO ° d ONLN déY Ëe¿ )02 is called to cancel the operation. The callback r R` ° d ONLN d¿Y¿eˇ )ÿoutine for the . ° d ONLN dœf är ’ (o äcanceled asynchr Ì` ° d ONLN dflf ’rm )K$onous function will also be called.
. ° d ONLN då äò (ï ä An application should not call ° d ONLN d-åòd )å
CmCloseDriver ° d ONLN d:ådòØ )N while a camera ° d ONLN dJò ä§ ˝ (° äconnection is active. Call ° d ONLN deò ˝§E )s CmDisconnect ° d ONLN dqòE§… )H to end the camera connection ° d ONLN dè§ ä∞ » (≠ äand then call ° d ONLN dù§ »∞ )>
The QuickT º@ ° d ONLN d3 µw ¡Ú )3 ake 100 driver has not been ° d ONLN dO ¿D Ãs ( …D initialized.
° d ONLN d\ ‰ * Ì Q ( Î *SEE ALSO
. ° d ONLN de Ú l ˛ ¢ +B CmConnect ° d ONLN dn Ú ¢ ˛ ∞ )6 on ° d ONLN dr Ú ∞ ˛ » )page ° d ONLN dw Ú » ˛ € )2-25 ° d ONLN d{ Ú € ˛ ‡ ), ° d ONLN d} Ú ‡ ˛. )
CmCloseDriver ° d ONLN dä Ú. ˛< )N on ° d ONLN dé Ú< ˛T )page ° d ONLN dì ÚT ˛g )2-21 ° d ONLN dó Úg ˛i )
" **¯ 4# **¯ % *%˛
ˇ·ˇ‚7^
. ° d ONLN dô *# H ( *Contr ˘Ä ° d ONLN dû H# ¶ ) olling the Camera ˇˇˇˇˇˇ ( Ú2
° d ONLN d±* l6 “ (3 lThe functions in this gr Œ ° d ONLN d…* “6 Ó )foup ar ë¿ ° d ONLN dœ* Ô6 ) e used to r Å¿ ° d ONLN d⁄* 6ÿ )..etrieve or set various characteristics of the ° d ONLN d7 lC å (@ lQuickT ÄÄ ° d ONLN d7 åCÀ ) Gake 100 camera, for example, getting or setting the camera owner name.
s *|¯ 4t *{¯ u *u˛
ˇ·ˇ‚7^
° d ONLN dVf *t í (p *CmGetCameraInfo ˇˇˇˇˇˇ (pÚ2
. ° d ONLN dgÖ lë§ (é l4pascal OSErr CmGetCameraInfo(CameraData cameraData, ° d ONLN d•ìü∂ +¢ CmCameraInfoPtr cameraInfo); ° d ONLN d¬´ l∑ ® (¥ l
cameraData ° d ONLN dÕ´ Æ∑ )BThe private data str l ° d ONLN d·´ ∑! )]uctur >` ° d ONLN dÊ´!∑, )e r ¿ ° d ONLN dÈ´,∑] ) eturned by ¿ ° d ONLN dÙ´]∑• )1 CmOpenDriver ¿ ° d ONLN d ´•∑ÿ )H when your . ° d ONLN d ∑ Æ√0 (¿ Æ application opens the QuickT ‰` ° d ONLN d'∑/√å )Åake 100 device driver ‡ ° d ONLN d<∑ç√í )^. . ° d ONLN d?« l” ® (– l
cameraInfo ° d ONLN dJ” Æfl Û +B Pointer to an ar R` ° d ONLN dZ” Ûfl )Eea lar $¿ ° d ONLN d`”flÇ )ge enough to hold an entir ˜ ° d ONLN dz”Åflà )se ˜ ° d ONLN d|”àfl– ) CmCameraInfo ˜ ° d ONLN dà”–fl“ )H . ° d ONLN dâfl ÆÎ π (Ë Æstr fi ° d ONLN dåfl πÎ – ) uctur c‡ ° d ONLN dëfl —Î ⁄ )e.
° d ONLN dï * c ( * DESCRIPTION
. ° d ONLN d° l Ä +BThe ° d ONLN d• Ä ⁄ )CmGetCameraInfo ° d ONLN d¥ ⁄ )Z function r R` ° d ONLN dø i ),etrieves information r $¿ ° d ONLN d’i « )celated to the QuickT 9¿ ° d ONLN dÈΔ Í )]ake 100 ° d ONLN dÒ l+ Ï (( l camera. The information is r R` ° d ONLN d
Ï+W )Äeturned in the form of a R` ° d ONLN d& W+ü )k CmCameraInfo R` ° d ONLN d2 ü+≈ )H data str >` ° d ONLN d; ≈+€ )&uctur ¿ ° d ONLN d@ €+Â )e, . ° d ONLN dC, l8 ß (5 l
described on °Ä ° d ONLN dP, ß8 æ );page |` ° d ONLN dU, ø8 — )2-14 –@ ° d ONLN dY, —8 ÷ ).
° d ONLN d\S *\ D (Z *RESUL ëÄ ° d ONLN daS D\ h )T CODES
. ° d ONLN di` ll ¸ +( Upon successful completion, the ° d ONLN dâ` ¸lV )êCmGetCameraInfo ° d ONLN dò`VlÇ )Z function r R` ° d ONLN d£`Çlü ),eturns R` ° d ONLN d™`ülΩ ) noErr R` ° d ONLN dØ`Ωl‰ ) and the ° d ONLN d∏m ly v (v lar R` ° d ONLN d∫m vy “ )
ea pointed to by the R` ° d ONLN dœm “y )\
cameraInfo R` ° d ONLN dŸmy{ )< parameter contains the R` ° d ONLN dÒm{y√ )m CmCameraInfo R` ° d ONLN d˝m√y› )H data . ° d ONLN dz lÜ w (É lstr fi ° d ONLN dz wÜ é ) uctur c‡ ° d ONLN d z èÜ ® )e corr J‡ ° d ONLN dz ®Ü )esponding to the curr C` ° d ONLN d&zÜt )_ently connected camera. ˇ @ ˇ ˇˇˇˇ @
, (‡2-29 4 ^ H¿ ° d ONLN d \ ä h Ω ( e ä Upon failur ° d ONLN d \ æ h )4e, this function r ◊ ° d ONLN d \ hö )G#eturns one of the values listed her ‘@ ° d ONLN d @ \ö h )ïe. Note that in these err „` ° d ONLN d Y \ h )gor . ° d ONLN d \ i ä u ˛ ( r äcases the content of the ar R` ° d ONLN d w i ˛ uH )tea pointed to by ,
)*or during communication ° d ONLN dk<bHô (Eb with QuickT S† ° d ONLN dv<ôHÎ )7ake 100 camera. W @ ° d ONLN dá<ÎH )Rindows ° d ONLN déGbSû (Pb
platform only _Ä ° d ONLN dõGûS£ )<.
_ Hm 4` Hm
° d ONLN dû^ äi ù (f äNote
ˇ·ˇ‚7^
° d ONLN d£k äw * Applications must allocate an ar ÓÄ ° d ONLN d√kwc )éea of memory lar ¿ ° d ONLN d”kdw« )Lge enough to hold the . ° d ONLN dÈw äÉ † (Ä äentir R` ° d ONLN dÓw †É ß )e R` ° d ONLN dw ßÉ Ô ) CmCameraInfo R` ° d ONLN d¸w ÔÉ ˝ )H str >` ° d ONLN d w ˝É )uctur ¿ ° d ONLN dwÉ? ) e or an err „ ° d ONLN dw>Éu )+ or may occur %¿ ° d ONLN d wuÉx )7. ,
Zapf Dingbats
. %¿ ° d ONLN d z}ÇÉ )u
. s¿ ° d ONLN d wÉÉÖ )
. ° d ONLN d!ú H• o (£ HSEE ALSO
. ° d ONLN d*™ ä∂ Í +BCmGetPictureInfo ° d ONLN d:™ Í∂4 )`, described next; ° d ONLN dL™4∂à )JCmGetErrorInfo ° d ONLN dZ™à∂ñ )T on ° d ONLN d^™ñ∂Æ )page ° d ONLN dc™Æ∂¡ )2-48 ° d ONLN dg™¡∂√ )
Ê HÔ 4Á HÓ Ë HË
ˇ·ˇ‚7^
. ° d ONLN diŸ HÁ ≠ („ HCmGetPictureInfo ˇˇˇˇˇˇ („2
. ° d ONLN d{¯ ä» ( ä5pascal OSErr CmGetPictureInfo(CameraData cameraData, ° d ONLN d∏û +~unsigned short pictureNo, ° d ONLN dŸ ¬ * CmPictureInfoPtr pictureInfo); ° d ONLN d˘, ä8 Δ (5 ä
cameraData ° d ONLN d, Ã8) )BThe private data str l ° d ONLN d,)8? )]uctur >` ° d ONLN d ,?8J )e r ¿ ° d ONLN d ,J8{ ) eturned by ¿ ° d ONLN d+,{8√ )1 CmOpenDriver ¿ ° d ONLN d7,√8ˆ )H when your . ° d ONLN dB8 ÃDN (A à application opens the QuickT ‰` ° d ONLN d^8MD™ )Åake 100 device driver ‡ ° d ONLN ds8´D∞ )^. . ° d ONLN dvH äT ¿ (Q ä pictureNo . ° d ONLN dÄH ÃT8 )BThe number that identifi ÿ‡ ° d ONLN dòH8Tì )les a particular pictur :† ° d ONLN dÆHîT¨ )\e stor > ° d ONLN d¥H¨T˘ )ed in the internal ° d ONLN d«T Ã`4 (] Ãmemory of the camera. . ° d ONLN dfid äp à (m ä pictureInfo . ° d ONLN dÍp Ã| +B Pointer to an ar Ö¿ ° d ONLN d˙p|[ )Dea of memory lar Ø ° d ONLN d
p[|œ )Kge enough to hold an entir ^‡ ° d ONLN d$p–|◊ )ue . ° d ONLN d&| Ãà (Ö Ã
CmPictureInfo ° d ONLN d3|à( )N str l ° d ONLN d7|(à> )uctur >` ° d ONLN d<|>àF )e. ˇ † @ ˇ ˇˇˇˇ @
Courier ° d ONLN d j Ä v ‡ )CmGetPictureInfo ° d ONLN d j ‡ v )` function r R` ° d ONLN d + j vo ),etrieves information r $¿ ° d ONLN d A jo vÓ )c elated to a particular pictur ˜ ° d ONLN d ^ jÌ vÙ )~e . ° d ONLN d ` w l É ö ( Ä l
image stor œ ° d ONLN d j w ö ÉÎ ).Med in the internal memory of the camera. The information is in the form of a . ° d ONLN d ∑ Ñ l ê ∫ ( ç l
CmPictureInfo ° d ONLN d ƒ Ñ ∫ ê ‡ )N data str l ° d ONLN d Õ Ñ ‡ ê ˆ )&uctur >` ° d ONLN d “ Ñ ˆ êc )e, which is described on >` ° d ONLN d Î Ñc ê{ )mpage >` ° d ONLN d Ñ{ êé )2-18 >` ° d ONLN d Ù Ñé êì ). . ° d ONLN d ˜ ñ l ¢ ≤ ( ü lEach image stor ¨` ° d ONLN d ñ ≤ ¢x )F+ed within the internal memory of the QuickT ~@ ° d ONLN d1 ñx ¢÷ )Δake 100 camera has a ° d ONLN dF £ l ØH ( ¨ l2numeric value associated with it. This number is r ¿ ° d ONLN dx £I Ø] )›eferr üÄ ° d ONLN d} £] ب )ed to as the pictur ¿` ° d ONLN dê £¨ Ø÷ )Oe number = ° d ONLN dò £÷ Ø€ )*. ° d ONLN dö ∞ l º õ ( π l Essentially † ° d ONLN d• ∞ õ º )/B, the camera uses numbers to name the images that have been captur PÄ ° d ONLN dÁ ∞ ºÌ ( π ed. The ° d ONLN dÔ Ω l … û ( Δ l
numbers ar Ú` ° d ONLN d˘ Ω û … Á )2e assigned in chr §† ° d ONLN d
Ω Ë …! )J
onological or IÄ ° d ONLN d Ω" …0 ):der d ° d ONLN d Ω0 …b ) , with the fi °` ° d ONLN d' Ωb …ä )2
rst pictur ¸† ° d ONLN d1 Ωä …œ )(e taken number ıÄ ° d ONLN d? Ωœ …ˆ )E
ed 1, the ° d ONLN dI l ÷ ú ( ” l next pictur o@ ° d ONLN dT ú ÷ · )0e taken number h ° d ONLN db · ÷f )E!ed 2, and so on. It is the pictur @‡ ° d ONLN dÉ f ÷à )Öe number that is specifi ‰Ä ° d ONLN dõ à ÷Ù )f
ed in the . ° d ONLN d• ◊ l „ ¢ ( ‡ l pictureNo ° d ONLN dÆ ◊ ¢ „ ‘ )6
parameter ¬† ° d ONLN d∏ ◊ ” „ ÿ )1. . ° d ONLN dª È l ı ô ( Ú l
The pictur % ° d ONLN d≈ È ö ıÁ ).Me numbering sequence starts again at the number 1 after a successful call to . ° d ONLN d ˆ l ù ( ˇ l either the ° d ONLN d ˆ ù « )1CmErase ° d ONLN d$ ˆ « Ê )* or the ° d ONLN d, ˆ Ê. ) CmEraseAsync ° d ONLN d8 ˆ.Y )H function.
. ° d ONLN dD *% D (# *RESUL ëÄ ° d ONLN dI D% h )T CODES
. ° d ONLN dQ* l6 ¸ +( Upon successful completion, the ° d ONLN dq* ¸6\ )êCmGetPictureInfo ° d ONLN dÅ*\6à )` function r R` ° d ONLN då*à6• ),eturns R` ° d ONLN dì*•6√ ) noErr R` ° d ONLN dò*√6Í ) and the ˇˇ€ê ° d ONLN d°7 lC v (@ lar R` ° d ONLN d£7 vC — )
ea pointed to by the ˇˇí∞ ú0 ° d ONLN d∏7 —C )[ pictureInfo ˇˇ€ê ú0 ° d ONLN d√7C )B parameter contains the ˇˇí∞
p ° d ONLN d€7ÄCŒ )m
CmPictureInfo ˇˇ€ê
p ° d ONLN dË7ŒC€ )N str “ ° d ONLN dÏ7€CÒ )
uctur §` ° d ONLN dÒ7ÒC˜ )e ° d ONLN dÛD lP } (M lcorr R` ° d ONLN d˜D }P ‰ )esponding to the pictur $¿ ° d ONLN dD ‰P )g e identifi $¿ ° d ONLN dDP: )*
ed by the $¿ ° d ONLN d"D:P| ), pictureInfo $¿ ° d ONLN d-D|PÆ )B
otocol err K` ° d ONLN dã+x7Ï )*or during communication ° d ONLN d£6DB{ (?D with QuickT S† ° d ONLN dÆ6{BÕ )7ake 100 camera. W @ ° d ONLN dø6ÕB )Rindows ° d ONLN dΔADMÄ (JD
platform only _Ä ° d ONLN d”AÄMÇ )<.
° d ONLN d’e *n Q (l *SEE ALSO
. ° d ONLN dfis l Δ +BCmGetCameraInfo ° d ONLN dÌs Δ ‘ )Z on ° d ONLN dÒs ‘ Ï )page ° d ONLN dˆs Ï ˇ )2-28 ° d ONLN d˙s ˇ ), ° d ONLN d¸sv )CmGetThumbnailImage ° d ONLN dsvÑ )r on ° d ONLN dsÑú )page ° d ONLN dsúØ )2-54 ° d ONLN d sØ¥ ), ° d ONLN d Ä lå ÿ (â lCmGetFullSizeImage ° d ONLN d0Ä ÿå Ê )l on ° d ONLN d4Ä Êå ˛ )page ° d ONLN d9Ä ˛å )2-57 ° d ONLN d=Äå ), ° d ONLN d?Äåj )CmGetErrorInfo ° d ONLN dMÄjåx )T on ° d ONLN dQÄxåê )page ° d ONLN dVÄêå£ )2-48 ° d ONLN dZÄ£å• ) ˇ§ @ ˇ ˇˇˇˇ @
. ° d ONLN d { ä áí ( Ñ ä,pascal OSErr CmErase(CameraData cameraData); ° d ONLN d 6 ì ä ü Δ *
cameraData ° d ONLN d A ì à ü) )BThe private data str l ° d ONLN d U ì) ü? )]uctur >` ° d ONLN d Z ì? üJ )e r ¿ ° d ONLN d ] ìJ ü{ ) eturned by ¿ ° d ONLN d h ì{ ü√ )1 CmOpenDriver ¿ ° d ONLN d t ì√ üˆ )H when your . ° d ONLN d ü à ´N ( ® à application opens the QuickT ‰` ° d ONLN d õ üM ´™ )Åake 100 device driver ‡ ° d ONLN d ∞ ü´ ´∞ )^.
° d ONLN d ≥ ≈ H Œ Å ( à H DESCRIPTION
. ° d ONLN d ø “ ä fi û +BThe ° d ONLN d √ “ û fi » )CmErase ° d ONLN d “ » fiµ )*6 function erases all of the images that have been stor R` ° d ONLN d “µ fi )Ìed in the internal ° d ONLN d fl ä Î Û ( Ë ämemory of the camera. !† ° d ONLN d) fl Û Îb )iAfter a successful call to !† ° d ONLN dD flb Îå )oCmErase !† ° d ONLN dK flå Îæ )* , the pictur Ù ° d ONLN dW flΩ ÎÙ )1 e numbering . ° d ONLN dc Ï ä ¯ ∏ ( ı ä
sequence r @¿ ° d ONLN dm Ï π ¯. )/estarts with the number 1.
H 4 H
° d ONLN dâ ä ù (
äNote
ˇ·ˇ‚7^
. ° d ONLN dé ä ° *If err R` ° d ONLN dî ° ∫ )ors ar $¿ ° d ONLN dö ∫ )e not detected, the $¿ ° d ONLN dÆ 9 )UCmErase $¿ ° d ONLN dµ9 « )*! function completes successfully ° d ONLN d÷ ä* ° (' äand r R` ° d ONLN d€ °* æ )eturns R` ° d ONLN d‚ æ* ‹ ) noErr ï ° d ONLN dÁ €*$ ) , even if the curr g` ° d ONLN d˘ $*¥ )I ently connected camera does not . ° d ONLN d* ä6 (3 ä contain any images to erase. ,
Zapf Dingbats
‡† ° d ONLN d6- 5 )Åu
.† ° d ONLN d7*6 )
° d ONLN d9P HY b (W HRESUL ëÄ ° d ONLN d>P bY Ü )T CODES
An asynchr <¿ ° d ONLN d·|ïàı )3onous operation is alr 5Ä ° d ONLN d˜|ıà )`eady ° d ONLN d¸ábìw (êbin pr ć ° d ONLN dáwìÖ )ogr JÄ ° d ONLN dáÜìò )ess. . ° d ONLN d
° d ONLN d \ * j | ( f * CmEraseAsync ˇˇˇˇˇˇ ( fÚ2 ,
Courier
. ° d ONLN d { l áí ( Ñ l1pascal OSErr CmEraseAsync(CameraData cameraData, ° d ONLN d D â ¥ ïÏ +H4CmAsyncCompletionRoutinePtr asyncCompletionRoutine); ° d ONLN d y ° l ≠ ® ( ™ l
cameraData ° d ONLN d Ñ ° Æ ≠ )BThe private data str l ° d ONLN d ò ° ≠! )]uctur >` ° d ONLN d ù °! ≠, )e r ¿ ° d ONLN d † °, ≠] ) eturned by ¿ ° d ONLN d ´ °] ≠• )1 CmOpenDriver ¿ ° d ONLN d ∑ °• ≠ÿ )H when your . ° d ONLN d ¬ ≠ Æ π0 ( ∂ Æ application opens the QuickT ‰` ° d ONLN d fi ≠/ πå )Åake 100 device driver ‡ ° d ONLN d Û ≠ç πí )^. . ° d ONLN d ˆ Ω l … ( Δ lasyncCompletionRoutine . ° d ONLN d
… Æ ’ ≈ +B Addr C¿ ° d ONLN d … Δ ’ )ess of a callback r ›¿ ° d ONLN d$ … ’° )L"outine to call when all the pictur Û¿ ° d ONLN dF …° ’Ω )èes stor 4@ ° d ONLN dM …æ ’Ê )
ed in the ° d ONLN dW ’ Æ ·( ( fi Æinternal memory of the curr 0¿ ° d ONLN dr ’) ·‰ ){)ently connected camera have been erased.
° d ONLN dú ˚ * c ( * DESCRIPTION
. ° d ONLN d® l Ä +BThe ° d ONLN d¨ Ä » ) CmEraseAsync ° d ONLN d∏ »0 )H function is the asynchr R` ° d ONLN d–0ä )honous version of the R` ° d ONLN dÂä¥ )ZCmErase R` ° d ONLN dÏ¥Ô )* function and . ° d ONLN d˙ l! ( lis pr ÏÄ ° d ONLN dˇ !1 ))ovided for applications that pursue a dif +¿ ° d ONLN d(2!> )≥fer @ ° d ONLN d+>![ ) ent thr D` ° d ONLN d2[!Ì ) !ead of execution during the time ° d ONLN dS" l. ñ (+ l
the pictur F† ° d ONLN d]" ó. ≥ )+es stor á ° d ONLN dd" ≥. ) ed in the camera ar … ° d ONLN dw".K )Te being erased. ° d ONLN dà4 l@) (= l(When the operation completes, the QuickT ° d ONLN d∞4)@ê )Ωake 100 driver calls the . ° d ONLN d…A lM ¸ (J lCmAsyncCompletionRoutine ° d ONLN d·A ¸MF )ê supplied as the ° d ONLN dÚAFM )JasyncCompletionRoutine ° d ONLN dA MÃ )Ñ ° d ONLN d N lZJ (W l3parameter to this function (see the description of ° d ONLN d<NJZ⁄ )fiCmAsyncCompletionRoutine ° d ONLN dTN⁄ZË )ê on . ° d ONLN dX[ lg É (d lpage Z‡ ° d ONLN d][ Ñg ñ )2-33 Æ¿ ° d ONLN da[ ñg õ )). ° d ONLN ddm ly á (v lFor W j† ° d ONLN dim áy
) indows applications, the addr ` ° d ONLN dÜm y` )Ñess of the callback r é¿ ° d ONLN dõm`yË )U outine handed to this function . ° d ONLN d∫z lÜ ∂ (É lmust be the one r R` ° d ONLN dÀz ∂Ü )Jeturned by the W ≈¿ ° d ONLN d€zÜK )Mindows function ≈¿ ° d ONLN dÎzKÜ´ )HMakeProcInstance ≈¿ ° d ONLN d˚z´ÜÆ )`.
ï *£¯ 4ï *¢¯
. ° d ONLN d˝ï lù ã (õ lIMPORT Ä ° d ONLN dï ãù õ ) ANT
° d ONLN d̓ Ÿ– € ) . ° d ONLN dÏ’ l· w (fi lW Û` ° d ONLN dÌ’ v·# )
&indows applications cannot cancel the Û` ° d ONLN d’#·k )≠ CmEraseAsync Û` ° d ONLN d ’k·¬ )H function by calling ° d ONLN d4‚ lÓ (Î lCmCancelAsyncOperation ° d ONLN dJ‚ Ó ı )Ñ.
. ° d ONLN dM * D ( *RESUL ëÄ ° d ONLN dR D h )T CODES
. ° d ONLN dZ l" ¸ +( Upon successful completion, the ° d ONLN dz ¸"D )ê CmEraseAsync ° d ONLN dÜD"p )H function r R` ° d ONLN dëp"ç ),eturns R` ° d ONLN dòç"´ ) noErr ï ° d ONLN dù™"Ø ) . ˇz @ ˇ ˇˇˇˇ @
, (‡2-33 4 ^ H¿ ° d ONLN d \ ä h ≠ ( e ä If an err Ö ° d ONLN d \ ≠ h )#or is detected, the value r ù† ° d ONLN d $ \ h¶ )o eturned is one of the following: ,
ovides one or mor $¿ ° d ONLN d ‰ ·T )Me implementations of the $¿ ° d ONLN d"‰T‰ )sCmAsyncCompletionRoutine $¿ ° d ONLN d:‰‰ )ê
function . ° d ONLN dDÒ ä˝ · (˙ äand passes the addr I¿ ° d ONLN dWÒ ‚˝— )X8ess of the function as the last parameter to the asynchr é‡ ° d ONLN dèÒ—˝Ó )Ôonous . ° d ONLN dï˛ ä
¥ ( ä
functions ° d ONLN dü˛ ¥
D )*CmGetThumbnailImageAsync ° d ONLN d∑˛D
U )ê (W Û` ° d ONLN d∫˛T
æ )indows platform only), ° d ONLN d— ä ( äCmGetFullSizeImageAsync ° d ONLN dË % )ä (W Û` ° d ONLN dÎ $é )indows platform only), ° d ONLN d ä$ ˆ (! äCmTakePictureAsync ° d ONLN d ˆ$ )l, and ° d ONLN d$V ) CmEraseAsync ° d ONLN d'V$[ )H. . ° d ONLN d** ä6 (3 äWhen any of these asynchr û` ° d ONLN dC*6ä )w onous functions completes its r Õ¿ ° d ONLN db*ä6ı )âespective operation, the ° d ONLN d{7 äC ™ (@ äQuickT ÄÄ ° d ONLN dÅ7 ™C; ) #ake 100 driver calls the callback r ‡ ° d ONLN d§7<C] )íoutine.
R H` 4R H_
° d ONLN d≠P ä[ ù (X äNote
ˇ·ˇ‚7^
° d ONLN d≤] äi • *For W j† ° d ONLN d∑] •i( ) indows applications, the addr ` ° d ONLN d‘])i~ )Ñess of the callback r é¿ ° d ONLN dÈ]~ià )Uoutine handed to ° d ONLN d˙i äu ∫ (r ä
an asynchr uÄ ° d ONLN di ∫uK )0 onous function must be the one r ‚‡ ° d ONLN d$iKuò )ëeturned by the W ܇ ° d ONLN d4iòuª )Mindows . ° d ONLN d;u äÅ ∞ (~ ä function ° d ONLN dDu ∞Å )&MakeProcInstance ° d ONLN dTuÅ )`. ,
Zapf Dingbats
. ° d ONLN dVxÄ )u
° d ONLN dXÜ äí (è ä The method by which the asynchr È ° d ONLN dwÜ íø )ñ%onous call status and bytes transferr ¿ ° d ONLN dúÜ¿íÁ )†ed (wher Ü ° d ONLN d§ÜÁíÓ )'e ° d ONLN d¶ì äü Δ (ú äapplicable) ar ó¿ ° d ONLN d¥ì Δü ◊ )<e pr ®Ä ° d ONLN d∏ì ◊üT ) ovided to the application dif $@ ° d ONLN d’ìUü )~ fers for the host platforms. ° d ONLN dÚ• ä± µ (Æ ä For the W » ° d ONLN d˚• µ± )+indows platform: ˇ | @ ˇ ˇˇˇˇ @
gsAsyncStatus ° d ONLN d \ Œ hr )N% global variable contains the value r R` ° d ONLN d 6 \r h” )§eturned by the synchr $¿ ° d ONLN d K \” hÌ )aonous . ° d ONLN d Q i l u Ô ( r l version of each of the asynchr Ó@ ° d ONLN d o i Ô u: )Éonous functions. . ° d ONLN d Å { l á Ä ( Ñ lThe ° d ONLN d Ö { Ä á ‘ )gulAsyncNBytes ° d ONLN d ì { ‘ ᶠ)T1 global variable is valid only for the functions ° d ONLN d ƒ à l î ¸ ( ë lCmGetThumbnailImageAsync ° d ONLN d ‹ à ¸ î )ê and ° d ONLN d · à îõ )CmGetFullSizeImageAsync ° d ONLN d ¯ àõ îÈ )ä and contains the . ° d ONLN d
ï l °E ( û l1number of bytes that have actually been transferr œ@ ° d ONLN d; ïE °ö )Ÿed to the image buf ° d ONLN dN ïõ °„ )Vfer allocated for ° d ONLN d` ¢ l Æ û ( ´ l
those calls.
º * ¯ 4 Ω * ¯
° d ONLN dn ª l Δ *Note
ˇ·ˇ‚7^
. ° d ONLN ds » l ‘
*#The values of the global variables ° d ONLN dñ »
‘X )û
gsAsyncStatus ° d ONLN d£ »X ‘m )N and ° d ONLN d® ‘ l ‡ ¿ ( › lgulAsyncNBytes ° d ONLN d∂ ‘ ¿ ‡ Ã )T ar R` ° d ONLN dπ ‘ Ã ‡v ) &e valid only during the time that the ° d ONLN dfl ‡ l Ï ¸ ( È lCmAsyncCompletionRoutine ° d ONLN d˜ ‡ ¸ Ï\ )ê function is called in r R` ° d ONLN d ‡\ Ïù )`esponse to the . ° d ONLN d Ï l ¯ € ( ı lcompletion of an asynchr ` ° d ONLN d6 Ï ‹ ¯& )ponous operation. ,
Zapf Dingbats
ƒ` ° d ONLN dG Ô+ ˜1 )Ou
° d ONLN dI ˝ l Í ( l For the Macintosh platform: ò† ° d ONLN de ˝ Í $ )~
A5 globals ar æ‡ ° d ONLN dr ˝$ ´ ): e saved into a long data type fi @ ° d ONLN dí ˝¨ ◊ )à eld in the ˇ˛¬* . ° d ONLN dù
◊ò ),e when the driver is initially opened. The f U^ ° d ONLN dfi
ôÒ )¬ield is located befor ÈË ° d ONLN dÛ
Ò˜ )Xe . ° d ONLN dı l# à ( lthe parameter block fi ` ° d ONLN d Õ#X )a"eld, which is also in the data str ì† ° d ONLN d-X#o )ãuctur Ä ° d ONLN d2p#‚ )e. When your completion ° d ONLN dJ$ l0 o (- lr E ° d ONLN dK$ p0M )4outine is called, a pointer to the parameter block fi ° d ONLN dÄ$N0§ )field can be found at ù@ ° d ONLN dî$§0€ )V A0 and the r t ° d ONLN d†$€0Ú )7esult ° d ONLN d¶1 l= † (: l code in D0. îÄ ° d ONLN d≤1 †= ¶ )4Y U ° d ONLN d≥1 ¶= Û )ou can access the ∂` ° d ONLN d≈1 Û=è )M$A5 globals by subtracting 4 bytes fr £@ ° d ONLN dÈ1è=≈ )ú om the addr Δ† ° d ONLN dÙ1≈=fl )6ess in e† ° d ONLN d˚1‡=Ò )A0.
° d ONLN d W *` D (^ *RESUL ëÄ ° d ONLN dW D` h )T CODES
. ° d ONLN d
f lr t +(A Û` ° d ONLN df sr ú )
value of Û` ° d ONLN df úr ∫ ))noErr Û` ° d ONLN d f ∫r5 ) indicates that the asynchr ≈¿ ° d ONLN d8f5r‡ ){'onous function completed successfully; ° d ONLN d_s l π (| lotherwise, an err R` ° d ONLN dps π fi )M or occurr $¿ ° d ONLN dys fiW )%ed and you should call the $¿ ° d ONLN dîsW´ )yCmGetErrorInfo $¿ ° d ONLN d¢s´‚ )T function for . ° d ONLN d∞Ä lå ’ (â ladditional information. ° d ONLN d…í lû ® *If the asynchr ≥‡ ° d ONLN d◊í ®ûz )<.onous function was canceled by the user in a W AÄ ° d ONLN dízûÍ )“indows application, then . ° d ONLN d ü l´ • (® l the camera r R` ° d ONLN d*ü •´ )9eturns the camera err $¿ ° d ONLN d?ü´m )_or and detail code pair $¿ ° d ONLN dWüm´¡ )ikCmErAttention $¿ ° d ONLN deü¡´÷ )T and ° d ONLN dj¨ l∏ fi (µ lkCmErCommandAborted ° d ONLN d}¨ fi∏
)r
when the ° d ONLN dá¨
∏a )/CMGetErrorInfo ° d ONLN dï¨a∏µ )T function is called. ° d ONLN d´æ l Ì (« lOn the Macintosh platform, ° d ONLN dΔæ Ì )ÅPBKillIO ° d ONLN dŒæ _ )0 is called. The ° d ONLN dfiæ_ ° )B kCmdTimeOut ° d ONLN dÈæ° ÷ )B GeoPort err R` ° d ONLN dıæ÷ ˆ )5or and ° d ONLN d˝À l◊ ¿ (‘ lkCmCameraError ° d ONLN d À ¿◊ à )T ar R` ° d ONLN dÀ Ã◊ ◊ ) e r $¿ ° d ONLN dÀ ◊◊[ ) eturned, but no additional err ˜ ° d ONLN d/ÀZ◊® )Éor detail codes ar …Ä ° d ONLN dAÀ®◊≥ )Ne r õ‡ ° d ONLN dDÀ≥◊Ù ) eturned to the ° d ONLN dSÿ l‰ ¿ (· lCmGetErrorInfo ° d ONLN daÿ ¿‰a )T& function. See the description of the ° d ONLN dáÿa‰µ )°CmGetErrorInfo ° d ONLN dïÿµ‰È )T
function on . ° d ONLN d¢Â lÒ É (Ó lpage Z‡ ° d ONLN dß ÑÒ ñ )2-48 Æ¿ ° d ONLN d´Â ñÒ Ô ) for details about err h ° d ONLN d¡Â Ò ˇ )Zor r @ ° d ONLN d≈ Ò; )eturn values.
° d ONLN d‘ * Q ( *SEE ALSO
. ° d ONLN d› l% ¸ +BCmGetThumbnailImageAsync ° d ONLN dı ¸%
)ê on ° d ONLN d˘
%" )page ° d ONLN d˛"%5 )2-56 ° d ONLN d5%: ), ° d ONLN d:%ƒ )CmGetFullSizeImageAsync ° d ONLN dƒ%“ )ä on ° d ONLN d & l2 Ñ (/ lpage ° d ONLN d$& Ñ2 ó )2-60 ° d ONLN d(& ó2 ú ), ° d ONLN d*& ú2 )CmTakePictureAsync ° d ONLN d<&2 )l on ° d ONLN d@&2. )page ° d ONLN dE&.2A )2-62 ° d ONLN dI&A2F ), ° d ONLN dK&F2é ) CmEraseAsync ° d ONLN dW&é2ú )H on ° d ONLN d[&ú2¥ )page ° d ONLN d`&¥2« )2-32 ° d ONLN dd&«2à ), ° d ONLN df3 l? ¿ (< lCmGetErrorInfo ° d ONLN dt3 ¿? Œ )T on ° d ONLN dx3 Œ? Ê )page ° d ONLN d}3 Ê? ˘ )2-48 ° d ONLN dÅ3 ˘? ), and ° d ONLN dá3?ï )CmCancelAsyncOperation ° d ONLN dù3ï?ò )Ñ, ° d ONLN dû3ò?‹ ) described next
. ° d ONLN d«Å lç> (ä l#pascal OSErr CmCancelAsyncOperation ° d ONLN dÚè Íõz +~(CameraData cameraData); ° d ONLN d ß l≥ ® (∞ l
cameraData ° d ONLN dß Æ≥ )BThe private data str l ° d ONLN d*ß ≥! )]uctur >` ° d ONLN d/ß!≥, )e r ¿ ° d ONLN d2ß,≥] ) eturned by ¿ ° d ONLN d=ß]≥• )1 CmOpenDriver ¿ ° d ONLN dIß•≥ÿ )H when your . ° d ONLN dT≥ Æø0 (º Æ application opens the QuickT ‰` ° d ONLN dp≥/øå )Åake 100 device driver ‡ ° d ONLN dÖ≥çøí )^. ˇ @ ˇ ˇˇˇˇ @
Courier ˇˇ> ?\ ° d ONLN d j û v" )CmCancelAsyncOperation ˇˇø\ ?\ ° d ONLN d & j" vS )Ñ function pr êt ° d ONLN d 2 jS v∏ )1ovides a method for W D ° d ONLN d G jπ v )findows applications ° d ONLN d [ w ä É ⁄ ( Ä äto cancel either a ° d ONLN d n w ⁄ Éj )PCmGetThumbnailImageAsync ° d ONLN d Ü wj Éπ )ê function call or a ° d ONLN d ö Ñ ä ê ( ç äCmGetFullSizeImageAsync ° d ONLN d ± Ñ êÇ )ä function call that is curr R` ° d ONLN d à ÑÇ ê÷ )nently outstanding. . ° d ONLN d ‡ ñ ä ¢ « ( ü äThe callback r »¿ ° d ONLN d Ó ñ « ¢ ˜ )= outine corr (Ä ° d ONLN d ˘ ñ ¯ ¢ˇ )1;esponding to the canceled operation is called by the QuickT ! ° d ONLN d4 ñˇ ¢ ( üˇake . ° d ONLN d8 £ ä Ø — ( ¨ ä100 driver befor R` ° d ONLN dH £ — Ø )Ge this function r $¿ ° d ONLN dY £ Øî )F eturns. The global variable $¿ ° d ONLN du £î Ø‚ )}
gsAsyncStatus $¿ ° d ONLN dÇ £‚ Ø˚ )N that . ° d ONLN dà ∞ ä º õ ( π äcorr ` ° d ONLN då ∞ ú º )esponds to the callback r Ë ° d ONLN d• ∞ º )l6outine for the canceled operation will contain the err ‘Ä ° d ONLN d€ ∞ º )Ëor and ˇˇ≥2 . ° d ONLN d‚ Ω ä … ‘ ( Δ ädetail code pair ˇˇñ ôñ ° d ONLN dÛ Ω ‘ …( )JkCmErAttention ˇˇ≥2 ôñ ° d ONLN d Ω( …< )T and ˇˇñ ˇ˙ ° d ONLN d Ω< …Æ )kCmErCommandAborted ˇˇ≥2 ˇ˙ ° d ONLN d ΩÆ … )r. See the description of ° d ONLN d2 ä ÷ ú ( ” äthe ° d ONLN d6 ú ÷ )CmGetErrorInfo ° d ONLN dD ÷$ )T
function on ° d ONLN dQ $ ÷< )4page ° d ONLN dV < ÷O )2-48 ° d ONLN dZ O ÷´ ) for details about err R` ° d ONLN dp ´ ÷∫ )\or r $¿ ° d ONLN dt ∫ ÷Ù )
eturn values. ° d ONLN dÇ ‹ ä Ë À ( Â äThis function r R` ° d ONLN dë ‹ À Ë Ë )Aeturns R` ° d ONLN dò ‹ Ë Ë6 )
kCmCantCancel R` ° d ONLN d• ‹6 ˶ )N if called while either a R` ° d ONLN dø ‹¶ ËÓ )p CmEraseAsync R` ° d ONLN dÀ ‹Ó Ë )H
function ° d ONLN d’ È ä ı ± ( Ú ä
call or a ° d ONLN dfl È ± ı )'CmTakePictureAsync ° d ONLN dÒ È ıù )l function call is outstanding.
H 4 H
. ° d ONLN d ä
ù (
äNote
ˇ·ˇ‚7^
° d ONLN d ä: *)This function is available only for the W Δ‡ ° d ONLN d?:Ü )∞indows platform. ,
Zapf Dingbats
b¿ ° d ONLN dPåí )Ru
∞¿ ° d ONLN dQíî )
° d ONLN dS4 H= b (; HRESUL ëÄ ° d ONLN dX4 b= Ü )T CODES
The QuickT º@ ° d ONLN d`ªï« )3 ake 100 driver has not been ° d ONLN d|Δb“ë (œb initialized.
° d ONLN dâÍ HÛ o (Ò HSEE ALSO
. ° d ONLN dí¯ ä +BCmGetThumbnailImageAsync ° d ONLN d™¯( )ê on ° d ONLN dƯ(@ )page ° d ONLN d≥¯@S )2-56 ° d ONLN d∑¯SX ), ° d ONLN dπ¯X‚ )CmGetFullSizeImageAsync ° d ONLN d–¯‚ )ä on ° d ONLN d‘ ä ¢ ( äpage ° d ONLN dŸ ¢ µ )2-60 ° d ONLN d› µ ∫ ), ° d ONLN dfl ∫& )CmTakePictureAsync ° d ONLN dÒ&4 )l on ° d ONLN dı4L )page ° d ONLN d˙L_ )2-62 ° d ONLN d˛_d ), ° d ONLN d d¨ ) CmEraseAsync ° d ONLN d ¨∫ )H on ° d ONLN d∫“ )page ° d ONLN d“ )2-32 ° d ONLN dÂÍ ), ° d ONLN d ä ( äCmAsyncCompletionRoutine ° d ONLN d3 ( )ê on ° d ONLN d7( @ )page ° d ONLN d<@ S )2-33 ° d ONLN d@S U )
N HW 4O HV P HP
ˇ·ˇ‚7^
. ° d ONLN dBA HO Ø (K HCmGetStdFeatures ˇˇˇˇˇˇ (K2
. ° d ONLN dT` äl» (i ä5pascal OSErr CmGetStdFeatures(CameraData cameraData, ° d ONLN dënzŒ +~!CmStdFeaturesPtr stdFeaturesPtr, ° d ONLN d∫|à\ *short length); ° d ONLN d…î ä† Δ (ù ä
. ° d ONLN d \ l h ¿ ( e lstdFeaturesPtr . ° d ONLN d h Æ tO +B $Pointer to a memory location to be fi ≠‡ ° d ONLN d 4 hO t™ )°lled with the standar F ° d ONLN d I h´ tÕ )\d featur
¿ ° d ONLN d Q hŒ tı )#
es of the ° d ONLN d [ t Æ Ä ( } Æunderlying device driver :† ° d ONLN d s t Ä )n. . ° d ONLN d u Ñ l ê ê ( ç llength ˇˇ~@ ° d ONLN d | Ñ Æ ê ı )BLength of the ar Õ ° d ONLN d å Ñ ı êN )Gea pointed to by the ˇ˛z¿ D` ° d ONLN d ° ÑO ê£ )ZstdFeaturesPtr ˇˇ~@ D` ° d ONLN d Ø Ñ£ ê‘ )T
parameter @ ° d ONLN d π Ñ‘ ê¯ )1
. This is . ° d ONLN d √ ê Æ úú ( ô Æ6the length in bytes of the amount of information you r ˝¿ ° d ONLN d ˘ êú ú≥ )Óequir ° d ONLN d ˛ ê¥ ú¬ )e fr wÄ ° d ONLN d ê¬ ú„ )om the . ° d ONLN d ú Æ ® ¸ ( • Æ
CmStdFeatures ° d ONLN d ú ¸ ®
)N str l ° d ONLN d ú
® )uctur >` ° d ONLN d ú ®ç )e, which is described on >` ° d ONLN d8 úç ®• )mpage >` ° d ONLN d= ú• ®∏ )2-10 >` ° d ONLN dA ú∏ ®Ω ).
. ° d ONLN dD ¡ * e ( » * DESCRIPTION
. ° d ONLN dQ œ l € Ä +BThe ° d ONLN dU œ Ä € ‡ )CmGetStdFeatures ° d ONLN de œ ‡ € )` function r R` ° d ONLN dp œ €⁄ ),.etrieves the version number of the underlying . ° d ONLN dû ‹ l Ë å (  lQuickT ÄÄ ° d ONLN d§ ‹ å Ë ) ake 100 device driver or W ;‡ ° d ONLN dæ ‹ Ë> )v indows DLL.
ˆ *¯ 4 ˜ *¯
° d ONLN dÀ ˜ l ˇ ã ( ˝ lIMPORT Ä ° d ONLN d— ˜ ã ˇ õ ) ANT
ˇ·ˇ‚7^
. ° d ONLN d’ l à ( lIf the ° d ONLN d‹ à ¨ ) length ° d ONLN d‚ ¨X )$( parameter is less than the size of the ° d ONLN d
X¶ )¨
CmStdFeatures ° d ONLN d¶® )N ˇˇ^ÿ ° d ONLN d l è ( ldata str ÿ ° d ONLN d è • )#uctur ù8 ° d ONLN d% • ø )e, the ˇ˛ à ZË ° d ONLN d, ¿ )CmGetStdFeatures ˇˇ^ÿ ZË ° d ONLN d< N )` function tr ò ° d ONLN dHO∞ )/uncates the data that ° d ONLN d^ l& z (# lit r R` ° d ONLN db z& π )eturns beyond R` ° d ONLN dp π& › )?length R` ° d ONLN dv ›& )$
bytes specifi R` ° d ONLN dÑ&% ):ed. ,
Zapf Dingbats
. R` ° d ONLN dà *%1 )s
. u` ° d ONLN dâ1&3 )
3 *A¯ 44 *A¯
. ° d ONLN dã2 l= (: lNote
ˇ·ˇ‚7^
ˇˇ’ö . ° d ONLN dê? lK *The ˇˇÄŒ Uö ° d ONLN dî? ÄK § )length ˇˇ’ö Uö ° d ONLN dö? §KP )$' parameter exists primarily for a futur )ñ ° d ONLN d¡?PK∞ )¨e enhancement to the . ° d ONLN d÷K lW ∑ (T lnumber of featur e¿ ° d ONLN dÊK ∑W< )K es available to the application.
È ° d ONLN dNAVG )äu
7 ° d ONLN dKHWJ )
° d ONLN d
p *y D (w *RESUL ëÄ ° d ONLN dp Dy h )T CODES
. ° d ONLN d~ lä ¸ +( Upon successful completion, the ° d ONLN d7~ ¸ä\ )êCmGetStdFeatures ° d ONLN dG~\äà )` function r R` ° d ONLN dR~àä• ),eturns R` ° d ONLN dY~•ä√ ) noErr R` ° d ONLN d^~√äÍ ) and the ˇˇ® ° d ONLN dgã ló v (î lar R` ° d ONLN diã vó – )
° d ONLN d \ H j ± ( f HCmGetProductInfo ˇˇˇˇˇˇ ( f2 ,
Courier
. ° d ONLN d { ä á» ( Ñ ä5pascal OSErr CmGetProductInfo(CameraData cameraData, ° d ONLN d O â ï¬ +~ CmProductInfoPtr productInfo); ° d ONLN d o ° ä ≠ Δ ( ™ ä
cameraData ° d ONLN d z ° à ≠) )BThe private data str l ° d ONLN d é °) ≠? )]uctur >` ° d ONLN d ì °? ≠J )e r ¿ ° d ONLN d ñ °J ≠{ ) eturned by ¿ ° d ONLN d ° °{ ≠√ )1 CmOpenDriver ¿ ° d ONLN d ≠ °√ ≠ˆ )H when your . ° d ONLN d ∏ ≠ à πN ( ∂ à application opens the QuickT ‰` ° d ONLN d ‘ ≠M π™ )Åake 100 device driver ‡ ° d ONLN d È ≠´ π∞ )^. . ° d ONLN d Ï Ω ä … à ( Δ ä productInfo . ° d ONLN d ¯ … à ’ „ +B Addr C¿ ° d ONLN d ¸ … ‰ ’7 )ess of a memory ar ~† ° d ONLN d …7 ’™ )Sea to which this function r fi‡ ° d ONLN d) …™ ’‚ )s
eturns the pr óÄ ° d ONLN d6 …„ ’˛ )9oduct . ° d ONLN d< ’ Ã · ( fi Ãinformation, a ° d ONLN dK ’ ·] )C
CmProductInfo ° d ONLN dX ’] ·É )N data str l ° d ONLN da ’É ·ô )&uctur >` ° d ONLN df ’ô ·¯ )e, for the camera curr ¿ ° d ONLN d| ’¯ · )_ently . ° d ONLN dÇ · Ã Ì ˝ ( Í Ã connected.
° d ONLN dé H Å ( H DESCRIPTION
. ° d ONLN dö ä û +BThe ° d ONLN dû û ˛ )CmGetProductInfo ° d ONLN dÆ ˛ * )` function r R` ° d ONLN dπ* Y ), eturns the R` ° d ONLN dƒY ß )/
CmProductInfo R` ° d ONLN d—ß Õ )N data str >` ° d ONLN d⁄Õ „ )&uctur ¿ ° d ONLN dfl„ Ó )e r „ ° d ONLN d‚Ì
)
elated ° d ONLN dÈ! ä- ∏ (* ä to the curr R` ° d ONLN dÙ! ∏-õ ).3ently connected camera. See the description of the R` ° d ONLN d'!õ-È )„
CmProductInfo R` ° d ONLN d4!È- )N data . ° d ONLN d:. ä: ï (7 ästr fi ° d ONLN d=. ï: ¨ ) uctur c‡ ° d ONLN dB. ≠: ¬ )e on t` ° d ONLN dG. ¬: Ÿ )page O@ ° d ONLN dL. ⁄: Ï )2-12 £ ° d ONLN dP. Ï: Ò ).
° d ONLN dSU H^ b (\ HRESUL ëÄ ° d ONLN dXU b^ Ü )T CODES
)*or during communication ° d ONLN dÅnbzô (wb with QuickT S† ° d ONLN dånôzÎ )7ake 100 camera. W @ ° d ONLN dùnÎz )Rindows ° d ONLN d§ybÖû (Çb
platform only _Ä ° d ONLN d±yûÖ£ )<.
° d ONLN d¥û Hß o (• HSEE ALSO
. ° d ONLN dΩ´ ä∑ Í +BCmGetStdFeatures ° d ONLN dÕ´ Í∑ ¯ )` on ° d ONLN d—´ ¯∑ )page ° d ONLN d÷´∑# )2-35 ° d ONLN d⁄´#∑( ), ° d ONLN d‹´(∑| )CmGetErrorInfo ° d ONLN dÍ´|∑ä )T on ° d ONLN dÓ´ä∑¢ )page ° d ONLN dÛ´¢∑µ )2-48 ° d ONLN d˜´µ∑∑ ) ˇ“ @ ˇ ˇˇˇˇ @
° d ONLN d \ * j ï ( f *CmRestoreDefaults ˇˇˇˇˇˇ ( fÚ2 ,
Courier
. ° d ONLN d { l á∞ ( Ñ l6pascal OSErr CmRestoreDefaults(CameraData cameraData); ° d ONLN d J ì l ü ® *
cameraData ° d ONLN d U ì Æ ü )BThe private data str l ° d ONLN d i ì ü! )]uctur >` ° d ONLN d n ì! ü, )e r ¿ ° d ONLN d q ì, ü] ) eturned by ¿ ° d ONLN d | ì] ü• )1 CmOpenDriver ¿ ° d ONLN d à ì• üÿ )H when your . ° d ONLN d ì ü Æ ´0 ( ® Æ application opens the QuickT ‰` ° d ONLN d Ø ü/ ´å )Åake 100 device driver ‡ ° d ONLN d ƒ üç ´í )^.
° d ONLN d « ≈ * Œ c ( à * DESCRIPTION
. ° d ONLN d ” ” l fl Ä +BThe ° d ONLN d ◊ ” Ä fl Ê )CmRestoreDefaults ° d ONLN d Ë ” Ê fl )f function r R` ° d ONLN d Û ” fl” ),-esets some of the characteristics of the curr $¿ ° d ONLN d ”” flÌ )¡ently . ° d ONLN d& ‡ l Ïö ( È lGconnected camera to their factory settings. The characteristics that ar a@ ° d ONLN dm ‡ö Ï• ( Èöe r o‡ ° d ONLN dp ‡• Ïı ) eset to the factory ° d ONLN dÑ Ì l ˘ ô ( ˆ l settings ar ÷@ ° d ONLN dè Ì ô ˘ † )-e
° d ONLN dì l ~ ( lItem ° d ONLN dò @ )ù
Default value
° d ONLN dß l! ö ( l
Image size ° d ONLN d≤!% )úHigh-r 3 ° d ONLN d∏&!N ) esolution ° d ONLN d√ l, Ã () lImage width in pixels ° d ONLN dŸ , )ú640 ° d ONLN dfi+ l7 Õ (4 lImage height in pixels ° d ONLN dı+7 )ú480 ° d ONLN d˙6 lB ü (? l
Flash mode ° d ONLN d6B6 )ú Automatic ° d ONLN dA lM Ó (J l Host interface timeout period ° d ONLN d.AM? )ú 2.55 seconds
e is not r ! ° d ONLN díq µ}j )&-everted to the factory setting by this call. ,
Zapf Dingbats
Ì ° d ONLN d¿to|u )∫u ° d ONLN d¬ó *† D (û *RESUL ëÄ ° d ONLN d«ó D† h )T CODES
. ° d ONLN dœ§ l∞ Í +( Upon successful completion, ° d ONLN dΧ Í∞P )~CmRestoreDefaults ° d ONLN d¸§P∞V )f r R` ° d ONLN d˛§V∞s )eturns R` ° d ONLN d§s∞ë ) noErr ï ° d ONLN d
otocol err K` ° d ONLN d~xäÏ )*or during communication ° d ONLN dâDï{ (íD with QuickT S† ° d ONLN d$â{ïÕ )7ake 100 camera. W @ ° d ONLN d5âÕï )Rindows ° d ONLN d<îD†Ä (ùD
platform only _Ä ° d ONLN dIîÄ†Ö )<. ˇ≤ @ ˇ ˇˇˇˇ @
CmSetDateAndT zÄ ° d ONLN d ≠ ≥ ¶ ¡ ∫ )^ime ˇˇˇˇˇˇ ( Ω2
. ° d ONLN d ≤ “ ä fi» ( € ä5pascal OSErr CmSetDateAndTime(CameraData cameraData, ° d ONLN d Ô ‡ Ϻ +~ CmDateAndTimePtr dateAndTime); ° d ONLN d ¯ ä Δ ( ä
cameraData ° d ONLN d ¯ Ã) )BThe private data str l ° d ONLN d- ¯)? )]uctur >` ° d ONLN d2 ¯?J )e r ¿ ° d ONLN d5 ¯J{ ) eturned by ¿ ° d ONLN d@ ¯{√ )1 CmOpenDriver ¿ ° d ONLN dL ¯√ˆ )H when your . ° d ONLN dW ÃN (
à application opens the QuickT ‰` ° d ONLN dsM™ )Åake 100 device driver ‡ ° d ONLN dà´∞ )^. . ° d ONLN dã ä à ( ä dateAndTime . ° d ONLN dó Ã, „ +B Addr C¿ ° d ONLN dõ ‰,7 )ess of a memory ar ~† ° d ONLN d≠ 7, )S5ea that contains the date and time to be set for the ° d ONLN d‚, Ã8 fi (5 Ãcurr Ø ° d ONLN dÊ, fi8K )ently connected camera.
° d ONLN dˇR H[ Å (Y H DESCRIPTION
ˇˇïT . ° d ONLN d _ äk ù +BThe ˇ˛ø¸ T ° d ONLN d_ ûk ˛ )CmSetDateAndTime ˇˇïT T ° d ONLN d _ ˛k )`> function changes the date and time maintained by the camera.
. ° d ONLN d^Ü Hè b (ç HRESUL ëÄ ° d ONLN dcÜ bè Ü )T CODES
. ° d ONLN d j l v ¿ +BCmSetOwnerName ° d ONLN d j ¿ v
)T, described next; ° d ONLN d ) j
vj )JCmSetPictureMode ° d ONLN d 9 jj vx )` on ° d ONLN d = jx vê )page ° d ONLN d B jê v£ )2-41 ° d ONLN d F j£ v® ), ° d ONLN d H w l É ¿ ( Ä lCmSetFlashMode ° d ONLN d V w ¿ É Œ )T on ° d ONLN d Z w Œ É Ê )page ° d ONLN d _ w Ê É ˘ )2-42 ° d ONLN d c w ˘ É ˚ )
≥ * º¯ 4 ¥ * ª¯ µ * µ˛
ˇ·ˇ‚7^
. ° d ONLN d e ¶ * ¥ ï ( ∞ *CmSetOwnerName ˇˇˇˇˇˇ ( ∞Ú2
. ° d ONLN d u ≈ l —ò ( Œ l2pascal OSErr CmSetOwnerName(CameraData cameraData, ° d ONLN d Ø ” Í flt +~BufferPtr* ownerName); ° d ONLN d « Î l ˜ ® ( Ù l
cameraData ° d ONLN d “ Î Æ ˜ )BThe private data str l ° d ONLN d Ê Î ˜! )]uctur >` ° d ONLN d Î Î! ˜, )e r ¿ ° d ONLN d Ó Î, ˜] ) eturned by ¿ ° d ONLN d ˘ Î] ˜• )1 CmOpenDriver ¿ ° d ONLN d Ε ˜ÿ )H when your . ° d ONLN d ˜ Æ0 ( Æ application opens the QuickT ‰` ° d ONLN d, ˜/å )Åake 100 device driver ‡ ° d ONLN dA ˜çí )^. . ° d ONLN dD l ¢ ( l ownerName . ° d ONLN dN Æ ≈ +B Addr C¿ ° d ONLN dR Δ Ö )/ess of a character string (32 bytes) to be stor ˘@ ° d ONLN dÅÖ Ë )øed in the camera. This ° d ONLN dò Æ+a (( Æ(string is used as the owner name identifi √‡ ° d ONLN d¡ a+Ò )≥ cation for the camera. The name ° d ONLN d·+ Æ7_ (4 Æ'has a maximum length of 26 characters.
° d ONLN d Q *Z c (X * DESCRIPTION
. ° d ONLN d^ lj Ä +BThe ° d ONLN d^ Äj ‘ )CmSetOwnerName ° d ONLN d'^ ‘jé )T( function changes the owner name identifi ° d ONLN dP^éj⁄ )∫cation of the curr R` ° d ONLN db^⁄jÙ )Lently ° d ONLN dhk lw ” (t lconnected camera. The ° d ONLN d~k ”w )g ownerName ° d ONLN dák wÚ )65 parameter points to an array of characters 32 bytes . ° d ONLN dºx lÑ ò (Å l in length.
ì *°¯ 4ì *†¯
° d ONLN d»ì lõ ã *IMPORT Ä ° d ONLN dŒì ãõ õ ) ANT
. £ ° d ONLN dŒw⁄y ) ˇˇ‚⁄ ° d ONLN dfl lÎ ê (Ë lThe curr 5: ° d ONLN d!fl ëή )%?ent value for the owner name of the camera is contained in the ˇˇ®é ∫L ° d ONLN d`fl®Îfi (Ë® ownerName ˇˇ‚⁄ ∫L ° d ONLN diflfiÎÊ )6 fi ù& ° d ONLN dlflÁΘ ) eld ° d ONLN dpÏ l¯ â (ı lof the ° d ONLN dwÏ â¯ — ) CmCameraInfo ° d ONLN dÉÏ —¯ ˜ )H data str l ° d ONLN dåÏ ˜¯
)&uctur >` ° d ONLN dëÏ
¯z )e, which is described on >` ° d ONLN d™Ïz¯í )mpage >` ° d ONLN dØÏí¯• )2-14 >` ° d ONLN d≥Ï•¯æ ). The ° d ONLN dπ˘ l ¥ ( l CmCameraInfo ° d ONLN d≈˘ ¥ ⁄ )H data str l ° d ONLN dŒ˘ ⁄ )&uctur >` ° d ONLN d”˘ )
e can be r ¿ ° d ONLN d›˘z )(etrieved via a call to ¿ ° d ONLN dÙ˘z‘ )bCmGetCameraInfo ¿ ° d ONLN d˘‘Ÿ )Z. . ° d ONLN d l fl ( lThe camera owner name r ` ° d ONLN d fl‘ )s:emains valid until the application issues another call to . ° d ONLN dW l$ ¿ (! lCmSetOwnerName ° d ONLN de ¿$ √ )T.
. ° d ONLN dg? *H D (F *RESUL ëÄ ° d ONLN dl? DH h )T CODES
ˇˇ’ö . ° d ONLN dtL lX +(The ˇˇÄŒ Uö ° d ONLN dxL ÄX ‘ )CmSetOwnerName ˇˇ’ö Uö ° d ONLN dÜL ‘X ˇ )T function r ”. ° d ONLN dëL ˇX )+eturns ˇˇÄŒ ®» ° d ONLN dòL X: ) noErr ˇˇ’ö ®» ° d ONLN dùL:Xz ) if the identifi )ñ ° d ONLN d≠L{X¯ )A cation has successfully been . ° d ONLN d Y le | (b lstor 9‡ ° d ONLN dŒY }e å )ed. ˇÆ @ ˇ ˇˇˇˇ @
, (‡2-41 4 ^ H¿ ° d ONLN d \ ä h ≠ ( e ä If an err Ö ° d ONLN d \ ≠ h )#or is detected, the value r ù† ° d ONLN d $ \ h¶ )o eturned is one of the following: ,
. ° d ONLN d‘« ä”» (– ä5pascal OSErr CmSetPictureMode(CameraData cameraData, ° d ONLN d’·™ +~unsigned char pictureMode); ° d ONLN d-Ì ä˘ Δ (ˆ ä
cameraData ° d ONLN d8Ì Ã˘) )BThe private data str l ° d ONLN dLÌ)˘? )]uctur >` ° d ONLN dQÌ?˘J )e r ¿ ° d ONLN dTÌJ˘{ ) eturned by ¿ ° d ONLN d_Ì{˘√ )1 CmOpenDriver ¿ ° d ONLN dkÌ√˘ˆ )H when your . ° d ONLN dv˘ ÃN ( à application opens the QuickT ‰` ° d ONLN dí˘M™ )Åake 100 device driver ‡ ° d ONLN dߢ´∞ )^. . ° d ONLN d™ ä à ( ä pictureMode . ° d ONLN d∂ Ã! ˘ +B
The pictur % ° d ONLN d¿ ˙!a ).e mode for the camera.
° d ONLN dÿ; HD Å (B H DESCRIPTION
. ° d ONLN d‰H äT û +BThe ° d ONLN dËH ûT ˛ )CmSetPictureMode ° d ONLN d¯H ˛Të )`" function changes the attributes r R` ° d ONLN dHëTÈ )ìelated to the pictur $¿ ° d ONLN d.HÈT )X
e mode of . ° d ONLN d8U äa œ (^ äthe camera curr å‡ ° d ONLN dGU œaG )Eently connected. The pictur ‡ ° d ONLN dbUGa
)x,e mode of the camera determines the type of ° d ONLN déb än § (k äpictur È@ ° d ONLN dîb §nA )%es that will be taken by the camera. . ° d ONLN d∫t äÄ (} ä The possible values for the ° d ONLN d÷tÄH )| pictureMode ° d ONLN d·tHÄÜ )B
parameter ar R` ° d ONLN dÓtÜÄæ )>
e as follows: ° d ONLN d¸Ö äë ∫ (é äkCmCOLOR . ° d ONLN dÖ Ãë. )BThe subsequent pictur ı ° d ONLN dÖ.ëâ )bes taken shall be stor R` ° d ONLN d0Öäë )\ed in full color ° d ONLN d@Ö ëà )@. . ° d ONLN dBï ä° ¿ (û ä kCmCOLORQ . ° d ONLN dLï ð. )BThe subsequent pictur ı ° d ONLN daï.°´ )b es taken shall be in full color ˆ‡ ° d ONLN dÄï´° )}, but the size will be ° d ONLN dó° Ã≠ œ (™ Ãr E ° d ONLN dò° –≠
)Keduced to one-quarter (320 by 240 pixels) of the default full size (640 by ° d ONLN d„≠ Ãπ ˇ (∂ Ã
\ ö h Ú ).e mode attributes ar ö ° d ONLN d \ Ú h )Xe in ef
@ ° d ONLN d % \
h⁄ )fect until either the application makes another ˇˇ…$ . ° d ONLN d V i l u ú ( r l call to the ,
Courier ˇˇ[l €l ° d ONLN d b i ú u ¸ )0CmSetPictureMode ˇˇ…$ €l ° d ONLN d r i ¸ u˜ )`: function to set new values, the application makes a call ° d ONLN d ¨ v l Ç w ( lto ° d ONLN d Ø v w Ç › ) CmRestoreDefaults ° d ONLN d ¿ v › Ç )f, or the user pr R` ° d ONLN d – v ÇX )@esses the corr $¿ ° d ONLN d fi vX Çã ); esponding r ˜ ° d ONLN d È vä ÇÒ )2esolution button on the . ° d ONLN d É l è ë ( å lcamera.
otocol err K` ° d ONLN dœx€Ï )*or during communication ° d ONLN d*⁄DÊ{ („D with QuickT S† ° d ONLN d5⁄{ÊÕ )7ake 100 camera. W @ ° d ONLN dF⁄ÕÊ )Rindows ° d ONLN dMÂDÒÄ (ÓD
platform only _Ä ° d ONLN dZÂÄÒÖ )<.
° d ONLN d] * Q ( *SEE ALSO
. ° d ONLN df l# “ +BCmRestoreDefaults ° d ONLN dw “# ‡ )f on ° d ONLN d{ ‡# ¯ )page ° d ONLN dÄ ¯# )2-38 ° d ONLN dÑ # ), ° d ONLN dÜ#d )CmSetOwnerName ° d ONLN dîd#r )T on ° d ONLN dòr#ä )page ° d ONLN dùä#ù )2-40 ° d ONLN d°ù#¢ ), ° d ONLN d£$ l0 ¿ (- lCmGetErrorInfo ° d ONLN d±$ ¿0 Œ )T on ° d ONLN dµ$ Œ0 Ê )page ° d ONLN d∫$ Ê0 ˘ )2-48 ° d ONLN dæ$ ˘0 ˛ ), ° d ONLN d¿$ ˛0R )CmSetFlashMode ° d ONLN dŒ$R0U )T, ° d ONLN dœ$U0ô ) described next
. ° d ONLN dr l~û ({ l3pascal OSErr CmSetFlashMode(CameraData cameraData, ° d ONLN d+Ä Íåb +~Boolean flashMode); ° d ONLN d@ò l§ ® (° l
cameraData ° d ONLN dKò Ƨ )BThe private data str l ° d ONLN d_ò §! )]uctur >` ° d ONLN ddò!§, )e r ¿ ° d ONLN dgò,§] ) eturned by ¿ ° d ONLN drò]§• )1 CmOpenDriver ¿ ° d ONLN d~ò•§ÿ )H when your . ° d ONLN d⧠Æ∞0 (≠ Æ application opens the QuickT ‰` ° d ONLN d•§/∞å )Åake 100 device driver ‡ ° d ONLN d∫§ç∞í )^. ˇ¨ @ ˇ ˇˇˇˇ @
Ò˚ )%9ently connected camera automatically determines how the fl 8Ä ° d ONLN d9
¸
(¸ash ° d ONLN d= Ã"] ( Ã!is used to take subsequent pictur [ ° d ONLN d^]"k )ëes. ° d ONLN dc' ä3 £ (0 äThe fl »Ä ° d ONLN di' £3
)ash mode setting is in ef ) ° d ONLN dÇ'3 )k<fect until either the application makes another call to the . ° d ONLN dæ4 ä@ fi (= äCmSetFlashMode ° d ONLN dÃ4 fi@ô )T+ function, the application makes a call to ° d ONLN d˜4ô@ˇ )ªCmRestoreDefaults ° d ONLN d4ˇ@ )f, or . ° d ONLN d
A äM π (J ä the user pr $‡ ° d ONLN dA ∫M Ù )0esses the corr ȇ ° d ONLN d&A ÙM+ ): esponding fl *‡ ° d ONLN d2A,Mû )8ash button on the camera.
° d ONLN dLg Hp b (n HRESUL ëÄ ° d ONLN dQg bp Ü )T CODES
)*or during communication ° d ONLN dœgbsô (pb with QuickT S† ° d ONLN d⁄gôsÎ )7ake 100 camera. W @ ° d ONLN dÎgÎs )Rindows ° d ONLN dÚrb~û ({b
platform only _Ä ° d ONLN dˇrû~£ )<.
° d ONLN dñ Hü o (ù HSEE ALSO
. ° d ONLN d § ä∞ fi +BCmSetOwnerName ° d ONLN d§ fi∞ Ï )T on ° d ONLN d § Ï∞ )page ° d ONLN d"§∞ )2-40 ° d ONLN d&§∞ ), ° d ONLN d(§ ∞| )CmSetPictureMode ° d ONLN d8§|∞ä )` on ° d ONLN d<§ä∞¢ )page ° d ONLN dA§¢∞µ )2-41 ° d ONLN dE§µ∞∫ ), ° d ONLN dG± äΩ (∫ äCmRestoreDefaults ° d ONLN dX± Ω ˛ )f on ° d ONLN d\± ˛Ω )page ° d ONLN da±Ω) )2-38 ° d ONLN de±)Ω. ), ° d ONLN dg±.ΩÇ )CmGetErrorInfo ° d ONLN du±ÇΩê )T on ° d ONLN dy±êΩ® )page ° d ONLN d~±®Ωª )2-48 ° d ONLN dDZªΩΩ ) ˇR @ ˇ ˇˇˇˇ @
. ° d ONLN d { l á ¸ ( Ñ lpascal OSErr CmSetSleep ° d ONLN d , â Í ïÏ +~+(CameraData cameraData, short sleepDelay); ° d ONLN d X ° l ≠ ® ( ™ l
cameraData ° d ONLN d c ° Æ ≠ )BThe private data str l ° d ONLN d w ° ≠! )]uctur >` ° d ONLN d | °! ≠, )e r ¿ ° d ONLN d °, ≠] ) eturned by ¿ ° d ONLN d ä °] ≠• )1 CmOpenDriver ¿ ° d ONLN d ñ °• ≠ÿ )H when your . ° d ONLN d ° ≠ Æ π0 ( ∂ Æ application opens the QuickT ‰` ° d ONLN d Ω ≠/ πå )Åake 100 device driver ‡ ° d ONLN d “ ≠ç πí )^. . ° d ONLN d ’ Ω l … ® ( Δ l
sleepDelay . ° d ONLN d ‡ Ω Æ … µ )BA ∫† ° d ONLN d · Ω µ … ) numeric value that r ˆÄ ° d ONLN d ˆ Ω … )\epr á@ ° d ONLN d ˘ Ω …Ÿ )+esents the period of time the camera shall ° d ONLN d$ … Æ ’ ± ( “ Ær E ° d ONLN d% … ≤ ’ ” )emain r ·` ° d ONLN d, … ” ’3 )!eady for command pr ”‡ ° d ONLN d? …3 ’q )`ocessing befor •¿ ° d ONLN dM …r ’„ )? e entering the sleep state.
° d ONLN dj Ô * ¯ c ( ˆ * DESCRIPTION
ˇˇzÇ . ° d ONLN dv ¸ l +BThe ˇ˛oÜ ˙Ç ° d ONLN dz ¸ ª )
B ºN )< parameter is expr R` ° d ONLN d BN¨ )R$essed as a number in the range 0 thr $¿ ° d ONLN dCB¨Nˆ )ûough 5 with the . ° d ONLN dSO l[ ∑ (X ldelay values corr † ° d ONLN ddO ∏[9 )L esponding to those shown in ¯† ° d ONLN dÄO9[? )ÅT .` ° d ONLN dÅO?[a )able 2-1 ;‡ ° d ONLN dâOa[f )".
Ä *௠4Ä *á¯ É lɯ
ˇ·ˇ‚7^
° d ONLN dåu lÄ ì (} l Table 2-1 . ° d ONLN dñu ™Ä )>CmSetSleep sleepDelay ° d ONLN d´uÄ[ )i parameter values . ° d ONLN døç kò q (ï kV 0 ° d ONLN d¿ç qò É )alue ° d ONLN d≈ç ¢ò ‚ )1
Constant name ° d ONLN d”çò9 )f Description
. ° d ONLN d‡õ lß r (§ l0 ° d ONLN d‚õ ¢ß ‰ )6 kCmSleepNow . ° d ONLN dÓõßö )f!Enter the sleep state immediately U ° d ONLN dõößü )í. . ° d ONLN d¶ l≤ r (Ø l1 ° d ONLN d¶ ¢≤ fi )6
kCmSleep5M . ° d ONLN d ¶≤› )f2Enter the sleep state after 5 minutes has elapsed. . ° d ONLN dT± lΩ r (∫ l2 ° d ONLN dV± ¢Ω ‰ )6 kCmSleep15M . ° d ONLN db±Ω‚ )f3Enter the sleep state after 15 minutes has elapsed. . ° d ONLN dóº l» r (≈ l3 ° d ONLN dôº ¢» ‰ )6 kCmSleep30M . ° d ONLN d•º»‚ )f3Enter the sleep state after 30 minutes has elapsed. . ° d ONLN d⁄« l” r (– l4 ° d ONLN d‹« ¢” ‰ )6 kCmSleep60M . ° d ONLN dË«”‚ )f3Enter the sleep state after 60 minutes has elapsed. . ° d ONLN d “ lfi r (€ l5 ° d ONLN d “ ¢fi )6
kCmSleepNever . ° d ONLN d-“fiÇ )f Do not enter the sleep state. ° d ONLN dK‰ l Õ (Ì lThe sleep delay time r ‡¿ ° d ONLN da‰ Õ£ )a1estarts after any command is sent to the camera.
ˇ *
¯ 4ˇ * ¯
° d ONLN dì˝ l ( lNote
ˇ·ˇ‚7^
° d ONLN dò
l ∂ *Once the QuickT E ° d ONLN dß
∂§ )J6ake 100 camera enters the sleep state, any subsequent . ° d ONLN d› l"
( l"commands sent to the camera will r R` ° d ONLN dˇ
"# )ûeturn R` ° d ONLN d#"k ) kCmCommError R` ° d ONLN dk"£ )H
because the . ° d ONLN d " l./ (+ l-serial port connection will have timed out. T T‡ ° d ONLN dK"/.: )√o r ` ° d ONLN dN";.h ) eestablish ° d ONLN dY. l: ˚ (7 l communication with the QuickT aÄ ° d ONLN dv. ˚:õ )è#ake 100 camera, the camera must be ° d ONLN dô: lFÜ (C l?manually switched on again. Then your application can call the . ° d ONLN dÿF lR ¥ * CmDisconnect ° d ONLN d‰F ¥R; )H function followed by a call to ° d ONLN dF;Rq )á CmConnect ° d ONLN d
FqR° )6 to make a . ° d ONLN dR l^ Ë ([ lconnection with the camera. ,
Zapf Dingbats
 ° d ONLN d4U Ì] Û )Åu
3 ° d ONLN d5R Ù^ ˆ )
° d ONLN d7x *Å D ( *RESUL ëÄ ° d ONLN d<x DÅ h )T CODES
. ° d ONLN dDÖ lë Ä +(The ° d ONLN dHÖ Äë º )
CmSetSleep ° d ONLN dRÖ ºë æ )< ° d ONLN dSÖ æë Ë )
function r R` ° d ONLN d]Ö Ëë )*eturns R` ° d ONLN ddÖë# ) noErr R` ° d ONLN diÖ#ë_ ) if successful. ˇ. @ ˇ ˇˇˇˇ @
, (‡2-45 4 ^ H¿ ° d ONLN d \ ä h ≠ ( e ä If an err Ö ° d ONLN d \ ≠ hu )#0or is detected, one of the following values is r â` ° d ONLN d 9 \u hö )»eturned: ,
)*or during communication ° d ONLN d /b;ô (8b with QuickT S† ° d ONLN d/ô;Î )7ake 100 camera. W @ ° d ONLN d%/Î; )Rindows ° d ONLN d,:bFû (Cb
platform only _Ä ° d ONLN d9:ûF£ )<.
t H} 4u H| v Hv
ˇ·ˇ‚7^
° d ONLN d<g Hu • (q H CmGetDecompT z@ ° d ONLN dHg §u ª )\able ˇˇˇˇˇˇ (q2
. ° d ONLN dNÜ äíŒ (è ä6pascal OSErr CmGetDecompTable (CameraData cameraData, ° d ONLN dèî>†‡ +¥BufferPtr decompTablePtr); ° d ONLN d´¨ ä∏ Δ (µ ä
cameraData ° d ONLN d∂¨ Ã∏) )BThe private data str l ° d ONLN d ¨)∏? )]uctur >` ° d ONLN dœ¨?∏J )e r ¿ ° d ONLN d“¨J∏{ ) eturned by ¿ ° d ONLN d›¨{∏√ )1 CmOpenDriver ¿ ° d ONLN dȨ√∏ˆ )H when your . ° d ONLN dÙ∏ ÃN (¡ à application opens the QuickT ‰` ° d ONLN d∏Mƒ™ )Åake 100 device driver ‡ ° d ONLN d%∏´ƒ∞ )^. . ° d ONLN d(» ä‘ fi (— ädecompTablePtr . ° d ONLN d7‘ Ã‡È +B APointer to the location in which this function writes the decompr û† ° d ONLN dx‘ȇ (›Èession ° d ONLN d‡ ÃÏ Û (È Ã data corr ˚Ä ° d ONLN dà‡ ÛÏü )'$esponding to the camera. The decompr gÄ ° d ONLN d¨‡†Ï˛ )≠ession information is ° d ONLN d¬Ï ïC (ı Ãneeded to expand images r ñ@ ° d ONLN d€ÏC¯q )w etrieved fr k` ° d ONLN dÊÏq¯˘ ). om the camera. The size of the ° d ONLN d¯ ÃM ( Ãmemory allocated must be gr « ° d ONLN d ¯MÌ )Å'eater than or equal to the size of the ° d ONLN dG à ◊ (
Ãstr fi ° d ONLN dJ ◊ Ó ) uctur c‡ ° d ONLN dO Ôs ) e, which is 98 bytes in length.
° d ONLN dp* H3 Å (1 H DESCRIPTION
. ° d ONLN d|8 äD û +BThe ° d ONLN dÄ8 ûD ˛ )CmGetDecompTable ° d ONLN dê8 ˛D* )` function r R` ° d ONLN dõ8*Dt ),eturns the compr $¿ ° d ONLN d´8tD∑ )Jession table str ¿ ° d ONLN dª8∑DÕ )Cuctur „ ° d ONLN d¿8ÃD” )e . ° d ONLN d¬E äQ õ (N äcorr ` ° d ONLN dΔE úQ ) esponding to the camera curr ñ` ° d ONLN d‚E Qq )Åently connected. W »¿ ° d ONLN dÙEqQı )T indows applications pass this . ° d ONLN dR ä^ ñ ([ ästr l ° d ONLN dR ñ^ ¨ ) uctur >` ° d ONLN dR ¨^ )e to the IPM with the >` ° d ONLN d0R^é )dIpSetCompressionTable >` ° d ONLN dERé^ )~ function. The IPM uses the . ° d ONLN da_ äk Í (h äinformation in this str @ ° d ONLN dx_ Îk )auctur í ° d ONLN d}_k< ) e to decompr y‡ ° d ONLN dâ_<kñ ):ess the image data fr ' ° d ONLN dû_ókÒ )[om the camera befor Æ ° d ONLN d±_Òk )Ze any ° d ONLN d∑l äx „ (u ädisplay of the pictur ¿ ° d ONLN dÃl „xà )Y%e can take place on the host computer @ ° d ONLN dÒlâxé )¶. ° d ONLN dÙ~ ää Ë (á äSee the functions defi Ì¿ ° d ONLN d
~ Ëä )^ned in ^@ ° d ONLN d~äê ) Chapter 4, “Displaying QuickT Ì ° d ONLN d.~èäÒ )àake 100 Images in a W ª ° d ONLN dC~Òä )bindows ° d ONLN dJã äó ≈ (î ä
Application,” ~ ° d ONLN dWã Δó È )< for mor H† ° d ONLN d_ã Íóá )$!e information about how the compr ê` ° d ONLN dÄãáófi )ùession table data str ª` ° d ONLN dïãfióı )Wuctur A@ ° d ONLN döãˆó˝ )e ° d ONLN dúò ä§ ç (° är E ° d ONLN dùò é§R )-eturned by this function is used by the IPM. ˇ¿ @ ˇ ˇˇˇˇ @
otocol err K` ° d ONLN däQx]Ï )*or during communication ° d ONLN d¢\Dh{ (eD with QuickT S† ° d ONLN d≠\{hÕ )7ake 100 camera. W @ ° d ONLN dæ\Õh )Rindows ° d ONLN d≈gDsÄ (pD
platform only _Ä ° d ONLN d“gÄsÖ )<.
° d ONLN d’ã *î Q (í *SEE ALSO
. ° d ONLN dfiô l• +BCmGetColorCorrectionMatrix ° d ONLN d¯ô•R )ú, described next; ° d ONLN d
ôR•¶ )JCmGetErrorInfo ° d ONLN dô¶•¥ )T on ° d ONLN d ô¥•Ã )page ° d ONLN d!ôÕfl )2-48 ° d ONLN d%ôfl•‰ ); . ° d ONLN d'¶ l≤ Ù (Ø l and the functions described in ™ ° d ONLN dF¶ Ù≤} )à Chapter 4, “Displaying QuickT 8‡ ° d ONLN dc¶}≤’ )âake 100 Images in a ° d ONLN dw≥ lø v (º lW Û` ° d ONLN dx≥ uø ò ) indows Ù ° d ONLN d≥ òø — )# Application” r ° d ONLN dã≥ “ø ‘ ):
Ô *¯¯ 4 *˜¯ Ò *Ò˛
ˇ·ˇ‚7^
° d ONLN dç‚ * Œ (Ï *CmGetColorCorrectionMatrix ˇˇˇˇˇˇ (ÏÚ2
V )NCmGetColorCorrectionMatrix ° d ONLN dÿ Íz +0(CameraData cameraData, ° d ONLN d¯ Í)™ * CmColorMatrixPtr colorMatrix); ° d ONLN d5 lA ® (> l
cameraData ° d ONLN d$5 ÆA )BThe private data str l ° d ONLN d85 A! )]uctur >` ° d ONLN d=5!A, )e r ¿ ° d ONLN d@5,A] ) eturned by ¿ ° d ONLN dK5]A• )1 CmOpenDriver ¿ ° d ONLN dW5•Aÿ )H when your . ° d ONLN dbA ÆM0 (J Æ application opens the QuickT ‰` ° d ONLN d~A/Må )Åake 100 device driver ‡ ° d ONLN dìAçMí )^. . ° d ONLN dñQ l] Æ (Z l colorMatrix ˇˇ¢Ë ° d ONLN d¢] Æi® +B :Pointer to the location in which this function writes the ˇ˛Ë∏ › ° d ONLN d‹]®iˆ )˙
CmColorMatrix ˇˇ¢Ë › ° d ONLN dÈ]ˆi˜ )N . ° d ONLN dÍi Æu ’ (r Æ data corr ˚Ä ° d ONLN dÛi ’uÙ )'?esponding to the camera. The size of the memory allocated must ˇˇ¶ . ° d ONLN d2u ÆÅ ¬ (~ Æbe gr ¯x ° d ONLN d7u ¬Åd )'eater than or equal to the size of the ˇ˛ÚH œP ° d ONLN d^ueÅ≥ )£
CmColorMatrix ˇˇ¶ œP ° d ONLN dku≥Åÿ )N data str Ä ° d ONLN dtuŸÅÔ )&uctur Ÿ‡ ° d ONLN dyuÓŘ )e. ˇ “ @ ˇ ˇˇˇˇ @
Courier ° d ONLN d k û w: )CmGetColorCorrectionMatrix ° d ONLN d * k: wf )ú function r R` ° d ONLN d 5 kf wï ), eturns the R` ° d ONLN d @ kï w„ )/
CmColorMatrix R` ° d ONLN d M k„ w˝ )N data . ° d ONLN d S x ä Ñ ï ( Å ästr fi ° d ONLN d V x ï Ñ ¨ ) uctur c‡ ° d ONLN d [ x ≠ Ñ Δ )e corr J‡ ° d ONLN d a x Δ ÑG ) esponding to the camera curr √‡ ° d ONLN d } xG Ñõ )Åently connected. W ˆ@ ° d ONLN d è xõ Ñ )Tindows applications must ° d ONLN d ® Ö ä ë ‘ ( é äpass this data str q` ° d ONLN d ∫ Ö ‘ ë Î )Juctur ˜@ ° d ONLN d ø Ö Î ëb ) e to the IPM to accurately r ° d ONLN d € Öc ëq )xepr û‡ ° d ONLN d fi Öq ëø )oduce the QuickT O ° d ONLN d Ó Öø ë
)Nake 100 image on ° d ONLN d ˇ í ä û – ( õ äthe host display ¬† ° d ONLN d í œ û2 )E. See the functions defi 0` ° d ONLN d' í3 ûQ )dned in †‡ ° d ONLN d. íQ û⁄ ) Chapter 4, “Displaying QuickT /† ° d ONLN dK í⁄ û˝ )âake 100 ° d ONLN dS ü ä ´ … ( ® ä
Images in a W ı` ° d ONLN d` ü » ´ Î )>indows ˆ ° d ONLN dg ü Î ´& )#
Application,” Ù ° d ONLN dt ü' ´J )< for mor æ† ° d ONLN d| üK ´Ì )$$e information about how the data str ¡† ° d ONLN d† üÌ ´ )¢uctur GÄ ° d ONLN d• ü ´ )e ° d ONLN dß ¨ ä ∏ ç ( µ är E ° d ONLN d® ¨ é ∏R )-eturned by this function is used by the IPM. ° d ONLN d’ ¨R ∏T )ƒ ° d ONLN d◊ æ ä : ( « ä&Since the color matrix and image compr d ° d ONLN d˝ æ: )∞/ession schemes in the camera may change in the ° d ONLN d, À ä ◊ † ( ‘ äfutur ÈÄ ° d ONLN d1 À † ◊‚ )Ke, it is always important to check the version number of the color matrix. ≥‡ ° d ONLN d| À„ ◊È ( ‘„Y t` ° d ONLN d} ÀÈ ◊ )ou must ° d ONLN dÖ ÿ ä ‰' ( · ä!make adjustments in your image pr ®Ä ° d ONLN d¶ ÿ' ‰
)ù3ocessing setup, based on the version number of the ° d ONLN dŸ Â ä Ò1 ( Ó ä'color matrix in the camera as follows: ° d ONLN d ˜ ä ¥ *On the W ~ ° d ONLN d ˜ ¥
)*Qindows platform, if the color matrix in the camera is version 1, use the default ° d ONLN dZ ä Á (
9ocessing. If it is not version 1, pass the color matrix r † ° d ONLN d‰{ )Á"eturned by the camera to the IPM. ° d ONLN d# ä/ (, äXOn the Macintosh platform, if the color matrix is not version 1, get the color matrix fr ı‡ ° d ONLN d_# / (, om ° d ONLN db0 ä< ÿ (9 äthe camera, and fi W¿ ° d ONLN dt0 Ÿ<; )Oll in the color matrix fi ú† ° d ONLN dç0;<§ )beld for the PICT QuickT § ° d ONLN d§0§<ª )iake fi ↠° d ONLN d™0º<◊ )le defi ≠¿ ° d ONLN d±0◊<Û )nition ° d ONLN d∏= äI Î (F äpasssed to the QuickT 4@ ° d ONLN dÕ= ÎI )a
ake QuickT k‡ ° d ONLN d◊= IW )2 ime decompr ÿ ° d ONLN d‚=WI ):+essor with the camera color matrix. If the ° d ONLN d
J äV (S äversion number is 1, pr ´† ° d ONLN d$J V∫ )f,ocess and display the images with the QuickT ]` ° d ONLN dPJ∫VÛ ) ake decompr ú` ° d ONLN d[JÛV )9essor ° d ONLN daW äcH (` ä(using the same method you use for QuickT º ° d ONLN dâWHcz )æ
ime PICT fi Ó† ° d ONLN dîWzcú )2 les. See 0† ° d ONLN dùWùc )#Chapter 5, “Displaying ° d ONLN d¥d äp ™ (m äQuickT ÄÄ ° d ONLN d∫d ™p3 ) ake 100 Images in a Macintosh b` ° d ONLN dÿd3pl )â Application” ‡Ä ° d ONLN d‰dlpè )9 for mor ´ ° d ONLN dÏdêpÍ )$e information about ° d ONLN d q ä} ‹ (z ädisplaying QuickT ° d ONLN dq ‹}µ )R.ake images on the Macintosh computer platform.
° d ONLN d@ó H† b (û HRESUL ëÄ ° d ONLN dEó b† Ü )T CODES
. ° d ONLN d j l v à +BCmGetDecompTable ° d ONLN d j à v ⁄ )` on ° d ONLN d j ⁄ v Ú )page ° d ONLN d " j Ú v )2-45 ° d ONLN d & j v
); ° d ONLN d ( j
v^ )CmGetErrorInfo ° d ONLN d 6 j^ vÕ )T, described next; and the . ° d ONLN d P w l É – ( Ä lfunctions described in fl† ° d ONLN d g w – ÉY )d Chapter 4, “Displaying QuickT n` ° d ONLN d Ñ wY ɪ )âake 100 Images in a W <Ä ° d ONLN d ô wª Éfi )bindows ° d ONLN d † Ñ l ê • ( ç l Application” ˛ ° d ONLN d ¨ Ñ • ê ß )9
¿ * …¯ 4 ¡ * »¯ ¬ * ¬˛
ˇ·ˇ‚7^
° d ONLN d Æ ≥ * ¡ Ñ ( Ω *CmGetErrorInfo ˇˇˇˇˇˇ ( ΩÚ2
. ° d ONLN d æ “ l fiû ( € l3pascal OSErr CmGetErrorInfo(CameraData cameraData, ° d ONLN d ˘ ‡ Í ÏV +~shortPtr category, ° d ONLN d Ó Í ˙V *shortPtr detail); ° d ONLN d& l ® ( l
cameraData ° d ONLN d1 Æ )BThe private data str l ° d ONLN dE ! )]uctur >` ° d ONLN dJ!, )e r ¿ ° d ONLN dM,] ) eturned by ¿ ° d ONLN dX]• )1 CmOpenDriver ¿ ° d ONLN dd•ÿ )H when your . ° d ONLN do Æ 0 ( Æ application opens the QuickT ‰` ° d ONLN dã/ å )Åake 100 device driver ‡ ° d ONLN d†ç í )^. . ° d ONLN d£" l. ú (+ lcategory . ° d ONLN d¨" Æ. ≈ )BAddr C¿ ° d ONLN d∞" Δ.q ))ess of a short into which this function r ⁄ ° d ONLN dŸ"q.Ú )´ eturns the category code of a . ° d ONLN d˜. Æ: (7 ÆkCmCameraError ° d ONLN d.: )T err R` ° d ONLN d .: )or ï ° d ONLN d .:M ) . The specif eÄ ° d ONLN d.M:≈ )4 ics of the category codes ar 7‡ ° d ONLN d3.≈:÷ )xe pr
ovided in . ° d ONLN dÒb Æn ¥ (k ÆT µ¿ ° d ONLN dÚb ≥n ’ )able 2-3 √@ ° d ONLN d˙b ’n  )" on
° d ONLN d˛b Ên ˝ )page  ° d ONLN db ˝n )2-50 8‡ ° d ONLN dbn ).
° d ONLN d à *ë c (è * DESCRIPTION
. ° d ONLN dï l° Ä +BThe ° d ONLN dï Ä° ‘ )CmGetErrorInfo ° d ONLN d'ï ‘° )T function r R` ° d ONLN d2ï °± ),'etrieves detailed information about err $¿ ° d ONLN dYï±°ƒ )±ors r ˜ ° d ONLN d^ï√°Ù ) eturned by ˇˇ¯ ° d ONLN di¢ lÆ Û (´ l the camera. The information r @ ° d ONLN dÜ¢ ÙÆ$ )à eturned by ˇˇ“Ë ¯0 ° d ONLN dë¢$Æx )0CmGetErrorInfo ˇˇ¯ ¯0 ° d ONLN dü¢xƘ )T is a pair of short integers in ° d ONLN døØ lª ï (∏ l the form ° d ONLN d»Ø ïª ≈ ))category d@ ° d ONLN d–Ø ƒª « )/, d@ ° d ONLN d—Ø «ª … ) d@ ° d ONLN d“Ø …ª Ì )detail d@ ° d ONLN dÿØ Ìª Ú )$. . ° d ONLN d€¡ lÕ ø ( lWhen a camera err Ó ° d ONLN dÏ¡ øÕ} )S-or is detected by a call to one of the QuickT Ã` ° d ONLN d¡}ÕÏ )æake 100 driver functions, . ° d ONLN d3Œ l⁄ ® (◊ lthe function r R` ° d ONLN dAŒ ®⁄ ≈ )<eturns R` ° d ONLN dHŒ ≈⁄ ) kCmCameraError ï ° d ONLN dVŒ⁄# )S. T ™ ° d ONLN dYŒ"⁄Î )
,o get detailed information about the camera ° d ONLN dÖ€ lÁ y (‰ lerr R` ° d ONLN dà€ yÁ Ç )
or ï ° d ONLN dä€ ÅÁ ö ), call ï ° d ONLN dë€ öÁ Ó )CmGetErrorInfo ï ° d ONLN dü€ ÓÁi )T . For example, a call to the ï ° d ONLN dº€iÁ… ){CmGetPictureInfo ï ° d ONLN dÀ…ÁÒ )`
function . ° d ONLN d÷Ë lÙ Ã (Ò lwith an invalid pictur ⁄@ ° d ONLN dÏË ÃÙû )`/e number parameter will cause the function to r ‡ ° d ONLN dËüÙ„ )”eturn a camera . ° d ONLN d*ı l y (˛ lerr R` ° d ONLN d-ı y Ñ )
or R` ° d ONLN d0ı Ñ ÿ ) kCmCameraError ï ° d ONLN d>ı ◊ ‚ )S. T ™ ° d ONLN dAı · Ô )
o fi ™ ° d ONLN dEı Ôµ )+nd out what condition caused the camera err |` ° d ONLN dpıµæ )Δor ø ° d ONLN drıΩ÷ ), call ° d ONLN dy l ¿ ( lCmGetErrorInfo ° d ONLN dá ¿ ˇ )T, which will r R` ° d ONLN dï ˇ* )?
eturn the R` ° d ONLN dü*Z )+category R` ° d ONLN dßZo )0 and R` ° d ONLN d¨oì )detail R` ° d ONLN d≤ì¡ )$ code pair ° d ONLN dΩ l Í ( lkCmErBadPictureNumber ° d ONLN d“ Í ˇ )~ and ° d ONLN d◊ ˇq )kCmErBadPictNumInfo ° d ONLN dÍqv )r. ° d ONLN dÌ! l- √ (* lThe category code r R` ° d ONLN d ! √- )Weturned in the ar $¿ ° d ONLN d!-j )Kea pointed to by the $¿ ° d ONLN d&!j-ö )\category $¿ ° d ONLN d.!ö-ÿ )0
\ » g ‰ )>QuickT @ ° d ONLN d \ ‰ g ) 7ake 100 driver error category codes, mnemonics, and defi
° d ONLN d H \ g‰ )Ênitions ° d ONLN d R t ä † ( | äCode ° d ONLN d W t Æ ⁄ )$Mnemonic ° d ONLN d ` t> N )êDefi Ä ° d ONLN d d tO g )nition
° d ONLN d l Ç ä é î ( ã ä00 ,
Courier . ° d ONLN d o Ç Æ é ˆ )$ kCmErNoError . ° d ONLN d | Ç> éfl )ê#The function completed successfully g ° d ONLN d ü Çfi é‡ )†. ° d ONLN d ¢ î ä † î ( ù ä01 . ° d ONLN d • î Æ † )$kCmErNoBattery . ° d ONLN d ¥ î> †q )ê Battery low µ¿ ° d ONLN d ø îp †Ì )2 , cannot complete operation. ° d ONLN d › ¶ ä ≤ î ( Ø ä02 . ° d ONLN d ‡ ¶ Æ ≤ )$kCmErMemoryFull . ° d ONLN d ¶> ≤˚ )ê*Image memory is full, cannot take another ° d ONLN d ±> ΩX * pictur È@ ° d ONLN d ±X Ω_ )e. ° d ONLN d$ √ ä œ î ( à ä03 . ° d ONLN d' √ Æ œ )$kCmErFlashNotReady . ° d ONLN d: √> œm )ê Flash not r T ° d ONLN dE √m œò )/
eady for r I† ° d ONLN dO √ò œÔ )+equested operation. ° d ONLN dd ’ ä · î ( fi ä04 . ° d ONLN dg ’ Æ ·2 )$kCmErImageMemoryDefect . ° d ONLN d~ ’> ·Z )êAn err ‡ ° d ONLN dÑ ’[ · ) )or has been detected in the camera image ° d ONLN d≠ ‡> Ïc ( È>memory Õ ° d ONLN d≥ ‡b Ïd )$. ° d ONLN d∂ Ú ä ˛ î ( ˚ ä05 . ° d ONLN dπ Ú Æ ˛ )$kCmErAttention . ° d ONLN d» Ú> ˛E )êA ∫† ° d ONLN d… ÚE ˛K ) r ˇ† ° d ONLN dÀ ÚK ˛â )ecoverable err L` ° d ONLN dŸ Úä ˛ )? or or camera state change has ° d ONLN d˜ ˝> (>/been detected. See also the description of the . ° d ONLN d&>∞ * kCmErCommandAborted ° d ONLN d9∞fi )r detail err R` ° d ONLN dDfi
). or code in . ° d ONLN dO> D ( >T µ¿ ° d ONLN dPC e )able 2-3 √@ ° d ONLN dXe g )". ° d ONLN d[% ä1 î (. ä06 . ° d ONLN d^% Æ1 )$kCmErParityError . ° d ONLN do%>1Z )êAn err ‡ ° d ONLN du%[1Ì ) or has been detected in the RAM. ° d ONLN dó7 äC î (@ ä07 . ° d ONLN dö7 ÆC )$kCmErTimeoutError . ° d ONLN d¨7>CE )êA ∫† ° d ONLN d≠7ECõ ) communication err l` ° d ONLN dø7úC )Wor between the camera ° d ONLN d’B>Nî (K>and host has occurr ÷Ä ° d ONLN dËBîN° )Ved. ° d ONLN dÌT ä` î (] ä08 . ° d ONLN dT Æ` )$kCmErHardwareError . ° d ONLN dT>`] )êAn unr 6 ° d ONLN d T^`û ) ecoverable har ò ° d ONLN dTû`µ )@dwar œ¿ ° d ONLN dTµ`» )e err ö† ° d ONLN d T…` )
, each err ˜@ ° d ONLN dC≤ æå )( or category has an associated 1† ° d ONLN da≤çæ• )Ñdetail * ° d ONLN dg≤¶æ ) code. The detail code . ° d ONLN d~ø äÀ é (» är R` ° d ONLN dø éÀ Ÿ )eturned in the ar $¿ ° d ONLN dêø ŸÀ5 )Kea pointed to by the $¿ ° d ONLN d•ø5ÀY )\detail $¿ ° d ONLN d´øYÀó )$
parameter pr ˜ ° d ONLN d∏øñÀ‘ )=
ovides specifi ˜ ° d ONLN dΔø‘À )>c information ° d ONLN d‘Ã äÿ ƒ (’ ä
about the err R` ° d ONLN d·Ã ƒÿ ):or that occurr $¿ ° d ONLN dÔà ÿõ )<!ed. The codes, mnemonics, and defi $¿ ° d ONLN dÃõÿÀ )õ nitions for $¿ ° d ONLN d ÃÀÿÔ )0detail $¿ ° d ONLN d#ÃÔÿ˚ )$ ar ˜ ° d ONLN d&Ã˙ÿ ) e . ° d ONLN d(Ÿ äÂ Ø (‚ ä
listed in o@ ° d ONLN d2Ÿ ∞ ∂ )&T • ° d ONLN d3Ÿ µÂ ◊ )able 2-3 ≤Ä ° d ONLN d;Ÿ ◊ )"
. Codes ar ¶` ° d ONLN dEŸÂf ),e hexadecimal values. ˇ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^ ° d ONLN d \ l g ì ( d l Table 2-3 ° d ONLN d
\ ™ g Δ )>QuickT @ ° d ONLN d \ Δ gª ) <ake 100 device driver error detail codes, mnemonics, and defi ã ° d ONLN d M \ª g◊ )ınitions ° d ONLN d X t l Ç ( | lCode ° d ONLN d ] t ê º )$Mnemonic ° d ONLN d f t 0 )êDefi Ä ° d ONLN d j t1 I )nition
° d ONLN d r Ç l é v ( ã l00 ,
Courier . ° d ONLN d u Ç ê é ÿ )$ kCmErNoError . ° d ONLN d Ç Ç é¡ )ê#The function completed successfully g ° d ONLN d • Ç¿ éfl )†, no err Ø ° d ONLN d ≠ Çfl éË ) or Y‡ ° d ONLN d Ø ÇË éÍ ) . ° d ONLN d ≤ î l † v ( ù l01 . ° d ONLN d µ î ê † ‰ )$kCmErNoBattery . ° d ONLN d ƒ î †S )ê Battery low µ¿ ° d ONLN d œ îR †œ )2 , cannot complete operation. ° d ONLN d Ì ¶ l ≤ v ( Ø l02 . ° d ONLN d ¶ ê ≤ Í )$kCmErMemoryFull . ° d ONLN d ¶ ≤› )ê*Image memory is full, cannot take another ° d ONLN d* ± Ω: * pictur È@ ° d ONLN d0 ±: ΩA )e. ° d ONLN d4 √ l œ v ( à l03 . ° d ONLN d7 √ ê œ ¸ )$kCmErFlashNotReady . ° d ONLN dJ √ œO )ê Flash not r T ° d ONLN dU √O œz )/
eady for r I† ° d ONLN d_ √z œ— )+equested operation. ° d ONLN dt ’ l · v ( fi l04 . ° d ONLN dw ’ ê · )$kCmErImageMemoryDefect . ° d ONLN dé ’ ·< )êAn err ‡ ° d ONLN dî ’= ·” ) "or has been detected in the image ° d ONLN d∂ ‡ ÏE ( È memory Õ ° d ONLN dº ‡D ÏI )$. ° d ONLN d¿ Ú l ˛ v ( ˚ l06 . ° d ONLN d√ Ú ê ˛ )$kCmErParityError . ° d ONLN d‘ Ú ˛' )êA ∫† ° d ONLN d’ Ú' ˛S ) parity err ÍÄ ° d ONLN d‡ ÚS ˛À ),or has been detected while ° d ONLN d˚ ˝ ) ( pr G ° d ONLN d˝ ˝* ™ )
ocessing the last command fr í@ ° d ONLN d ˝™ ‡ )Ä om the host. ° d ONLN d' l v ( l07 . ° d ONLN d* ê ˆ )$kCmErTimeoutError . ° d ONLN d< x )êThe host timed out. ° d ONLN dR! l- w (* l0B . ° d ONLN dU! ê- )$kCmErGeneralHWError . ° d ONLN di! -X )ê An unspecifi fl@ ° d ONLN du!X-t )8ed har € ° d ONLN d{!t-ã ) dwar ¿ ° d ONLN d!å-ü )e err ›† ° d ONLN dÑ!ü-” ) or has been ° d ONLN dê, 8H (5 detected. ° d ONLN dõ> lJ x (G l0C . ° d ONLN dû> êJ ˆ )$kCmErCPUError4Bit . ° d ONLN d∞> J< )êAn err ‡ ° d ONLN d∂>=Jı ) *or has been detected inside the 4-bit CPU. ° d ONLN d‚P l\ x (Y l0D . ° d ONLN dÂP ê\ ˆ )$kCmErCPUError8Bit . ° d ONLN d˜P \< )êAn err ‡ ° d ONLN d˝P=\ı ) *or has been detected inside the 8-bit CPU. ° d ONLN d)b ln w (k l0E . ° d ONLN d,b ên fi )$
kCmErDSPError . ° d ONLN d:b n< )êAn err ‡ ° d ONLN d@b=n⁄ ) #or has been detected inside the DSP dÄ ° d ONLN dcbŸn€ )ú. ° d ONLN dft lÄ v (} l0F . ° d ONLN dit êÄ )$kCmErFrameMemoryError . ° d ONLN dt Ä< )êAn err ‡ ° d ONLN dÖt=Ä— ) "or has been detected in the frame ° d ONLN dß ãE (à memory Õ ° d ONLN d≠DãF )$. ° d ONLN d∞ë lù v (ö l10 . ° d ONLN d≥ë êù )$kCmErImageMemoryError . ° d ONLN d…ë ùÇ )êAn image memory err ó‡ ° d ONLN d‹ëÇùŒ )bor other than the . ° d ONLN dÓú ®§ (• kCmErImageMemoryDefect ° d ONLN dú§®≥ )Ñ err R` ° d ONLN dú≥®Á ) or has been . ° d ONLN dß ≥J (∞
detected. ° d ONLN d π l≈ q (¬ l1 Û` ° d ONLN d!π p≈ u )1 . ° d ONLN d#π ê≈ ) kCmErInvalidCmdCode . ° d ONLN d7π ≈} )êThe operation code fi 9 ° d ONLN dLπ~≈Í )^eld of the last command ° d ONLN ddƒ –‚ (Õ -block issued by the host contains an invalid ° d ONLN dëœ €: * value. ° d ONLN dô· lÌ v (Í l12 . ° d ONLN dú· êÌ )$kCmErInvalidControlCmd . ° d ONLN d≥· Ì\ )êThe last contr b ° d ONLN d¡·\ÌÊ )< ol command code is unknown. ° d ONLN dflÛ lˇ v (¸ l13 . ° d ONLN d‚Û êˇ )$kCmErInvalidCmdData . ° d ONLN dˆÛ ˇS )ê
One or mor mÄ ° d ONLN d ÛSˇ´ )3e parameters specifi s@ ° d ONLN dÛ´ˇ” )X
ed in the ° d ONLN d ˛
ı ( -command descriptor block in the last command ° d ONLN dK ' * fr ò‡ ° d ONLN dM '— )'om the host contains an invalid value. ° d ONLN dv l' v ($ l14 . ° d ONLN dy ê' )$kCmErInvalidData . ° d ONLN dä 'ù )êAn invalid value was specifi Δ† ° d ONLN d¶ù'ı )}ed in the additional ° d ONLN dª& 2„ (/ +data following the last command descriptor ° d ONLN dÊ1 =: * block. ° d ONLN dÓC lO v (L l15 . ° d ONLN dÒC êO “ )$ kCmErNoData . ° d ONLN d˝C O÷ )ê+No additional data to be sent to the host. ° d ONLN d*U la v (^ l16 . ° d ONLN d-U êa )$kCmErBadPicNumImage . ° d ONLN dAU a' )êA ∫† ° d ONLN dBU'aD ) pictur £‡ ° d ONLN dIUDa] ) e corr ä‡ ° d ONLN dOU]aΔ )esponding to the specifi ¬Ä ° d ONLN dgUΔaÌ )i ed pictur ë ° d ONLN dpUÓaı )(e ° d ONLN dr` lÑ (i number does not exist. ° d ONLN där l~ v ({ l17 . ° d ONLN dçr ê~ )$kCmErBadPictNumInfo ° d ONLN d°r ~( )êA Û` ° d ONLN d¢r'~) ) Û` ° d ONLN d£r)~w )
CmPictureInfo Û` ° d ONLN d∞rw~ù )N data str fl` ° d ONLN dπrù~≥ )&uctur ±¿ ° d ONLN dær≥~∫ )e . ° d ONLN d¿} â1 (Ü corr ` ° d ONLN dƒ}2âõ )esponding to the specifi U ° d ONLN d‹}õ⬠)i ed pictur #† ° d ONLN dÂ}√âÔ )( e number ° d ONLN dÓà î^ (ë does not exist.
\ » g ‰ )>QuickT @ ° d ONLN d \ ‰ gŸ ) <ake 100 device driver error detail codes, mnemonics, and defi ã ° d ONLN d M \Ÿ gı )ınitions
q H x 4 q H x t ä t
ˇ·ˇ‚7^ ° d ONLN d U f » q ı ( n » (continued) ° d ONLN d c ~ ä â † ( Ü äCode ° d ONLN d h ~ Æ â ⁄ )$Mnemonic ° d ONLN d q ~> âN )êDefi Ä ° d ONLN d u ~O âg )nition
° d ONLN d } å ä ò î ( ï ä18 ,
Courier . ° d ONLN d Ä å Æ ò )$kCmErCommandAborted . ° d ONLN d î å> òp )ê
An asynchr <¿ ° d ONLN d û åq ò‰ )3onous operation has been ° d ONLN d ∑ ó> £¯ ( †>,successfully terminated by the host. If the ° d ONLN d „ ¢> ƃ * application cancels an asynchr Õ@ ° d ONLN d ¢ƒ Æ )Üonous operation ° d ONLN d ≠> π ( ∂>3and if the operation is successfully canceled, the ° d ONLN dD ∏> ƒh *
callback r ç ° d ONLN dN ∏h ƒ⁄ )*outine for that operation r L ° d ONLN di ∏€ ƒ )s eturns a . ° d ONLN dr √> œ| ( Ã>status code of ° d ONLN dÅ √| œ )>
CmCameraError ¬† ° d ONLN dé √… œŒ )M. d@ ° d ONLN dê √Œ œ÷ )A ◊† ° d ONLN dë √’ œˆ ) call to ˇ˛ñŒ ° d ONLN dö Œ> ⁄í ( ◊>CmGetErrorInfo ˇˇáö ° d ONLN d® Œí ⁄√ )T will then r È. ° d ONLN d¥ Œ√ ⁄ )1eturn the category ° d ONLN d« Ÿ> Âú ( ‚>and detail code pair ° d ONLN d‹ Ÿú  )^kCmErAttention ° d ONLN dÍ Ÿ  )T and ° d ONLN dÔ ‰> ∞ ( Ì>kCmErCommandAborted ° d ONLN d ‰∞ ∑ )r . . ° d ONLN d ˆ ä î ( ˇ ä19 . ° d ONLN d
ˆ Æb )$ kCmErTooManyImageMemoryDefects . ° d ONLN d)>
Z +ê An err ‡ ° d ONLN d/[
Ò ) "or has been detected in the image ° d ONLN dQ >∏ (> memory after all of the spar 7 ° d ONLN dm π ){e image memory ° d ONLN d|>#• ( >blocks have been used.
/ H= 40 H=
° d ONLN dî. ä9 ù (6 äNote
ˇ·ˇ‚7^
. ° d ONLN dô; äG fi *CmGetErrorInfo ° d ONLN dß; fiG )T
itself may r R` ° d ONLN d¥;G. )7eturn R` ° d ONLN d∫;.GÇ )kCmCameraError ï ° d ONLN d»;ÅGÑ )S. ,
Zapf Dingbats
. ï ° d ONLN d >âFè )u
. „ ° d ONLN dÀ;èGë ) ° d ONLN dÕL äX À (U äThis function r R` ° d ONLN d‹L ÀX Ë )Aeturns R` ° d ONLN d„L ËX ) noErr R` ° d ONLN dËLX ) 8 when called without your application having detected a ° d ONLN d Y äe fi (b äkCmCameraError ° d ONLN d.Y fie Ì )T err R` ° d ONLN d2Y Ìe ˆ )or ï ° d ONLN d4Y ıeN ). In this case, the ar g` ° d ONLN dJYNeú )Yeas pointed to by g` ° d ONLN d\Yúeà )Ncategory g` ° d ONLN ddYÃe· )0 and g` ° d ONLN diY·e )detail g` ° d ONLN doYe )$ ° d ONLN dpf är ⁄ (o äwill both contain ° d ONLN dÇf ⁄r" )P kCmErNoError ¬† ° d ONLN déf!r$ )G.
. ° d ONLN dêå Hï b (ì HRESUL ëÄ ° d ONLN dïå bï Ü )T CODES
. ° d ONLN dùö ä¶ û +(The ° d ONLN d°ö û¶ Ú )CmGetErrorInfo ° d ONLN dØö Ú¶ )T function r R` ° d ONLN d∫ö ¶; ),eturns R` ° d ONLN d¡ö;¶Y ) noErr R` ° d ONLN dΔöY¶r ) if err $¿ ° d ONLN dÕör¶ˇ ) or information has successfully ° d ONLN dÌß ä≥ § (∞ äbeen r R` ° d ONLN dÛß §≥ ’ ) etrieved fr $¿ ° d ONLN d˛ß ’≥* )1om the camera curr ˜ ° d ONLN dß)≥ë )Tently connected. The ar …Ä ° d ONLN d'ßë≥fl )heas pointed to by …Ä ° d ONLN d9ßfl≥ )Ncategory …Ä ° d ONLN dAß≥ )0 ° d ONLN dB¥ ä¿ ù (Ω äand ° d ONLN dF¥ ù¿ ¡ )detail ° d ONLN dL¥ ¡¿L )$ contain detailed information r R` ° d ONLN dk¥L¿™ )ãelated to the last err $¿ ° d ONLN dÅ¥™¿· )^
All QuickT òÄ ° d ONLN d j ú v )0ake 100 driver functions
¶ * د 4 ß * Ư ® * ®˛
ˇ·ˇ‚7^
° d ONLN d - ô * ß ã ( £ *CmCheckIfReady ˇˇˇˇˇˇ ( £Ú2 ,
Courier
. ° d ONLN d = ∏ l ƒû ( ¡ l3pascal OSErr CmCheckIfReady(CameraData cameraData); ° d ONLN d q – l ‹ ® *
cameraData ° d ONLN d | – Æ ‹ )BThe private data str l ° d ONLN d ê – ‹! )]uctur >` ° d ONLN d ï –! ‹, )e r ¿ ° d ONLN d ò –, ‹] ) eturned by ¿ ° d ONLN d £ –] ‹• )1 CmOpenDriver ¿ ° d ONLN d Ø –• ‹ÿ )H when your . ° d ONLN d ∫ ‹ Æ Ë0 ( Â Æ application opens the QuickT ‰` ° d ONLN d ÷ ‹/ Ëå )Åake 100 device driver ‡ ° d ONLN d Î ‹ç Ëí )^.
° d ONLN d Ó * c ( * DESCRIPTION
. ° d ONLN d ˙ l Ä +BThe ° d ONLN d ˛ Ä ‘ )CmCheckIfReady ° d ONLN d ‘† )T, function determines whether the camera curr R` ° d ONLN d8†Ò )Ãently connected is . ° d ONLN dK l( o (% lr E ° d ONLN dL p( )#eady for subsequent host command pr M¿ ° d ONLN do (ã )™ocessing. This function pr ¨‡ ° d ONLN dâ ã(Ú )qovides a simple way to ° d ONLN d†) l5 Å (2 lconfi C‡ ° d ONLN d•) Ç5 « )rm that the curr Ì ° d ONLN dµ) «5∞ )E7ently connected camera is still connected to the host.
° d ONLN dÌP *Y D (W *RESUL ëÄ ° d ONLN dÚP DY h )T CODES
. ° d ONLN d˙] li ¿ +(CmCheckIfReady ° d ONLN d] ¿i Δ )T r R` ° d ONLN d
] Δi „ )eturns R` ° d ONLN d] „i ) noErr R` ° d ONLN d]iP ) if the camera is r $¿ ° d ONLN d)]Pi~ )O
eady to pr ˜ ° d ONLN d3]}iÕ )-ocess commands fr …Ä ° d ONLN dD]ÕiÓ )Pom the . ° d ONLN dKj lv ¨ (s l
° d ONLN d \ H j y ( f HCmSelfT ~Ä ° d ONLN d \ x j á )0est ˇˇˇˇˇˇ ( f2 ,
Courier
. ° d ONLN d { ä á™ ( Ñ ä0pascal OSErr CmSelfTest(CameraData cameraData); ° d ONLN d = ì ä ü Δ *
cameraData ° d ONLN d H ì à ü) )BThe private data str l ° d ONLN d \ ì) ü? )]uctur >` ° d ONLN d a ì? üJ )e r ¿ ° d ONLN d d ìJ ü{ ) eturned by ¿ ° d ONLN d o ì{ ü√ )1 CmOpenDriver ¿ ° d ONLN d { ì√ üˆ )H when your . ° d ONLN d Ü ü à ´N ( ® à application opens the QuickT ‰` ° d ONLN d ¢ üM ´™ )Åake 100 device driver ‡ ° d ONLN d ∑ ü´ ´∞ )^.
° d ONLN d ∫ ≈ H Œ Å ( à H DESCRIPTION
. ° d ONLN d Δ “ ä fi +BThe application calls the ° d ONLN d ‡ “ fi< )v
CmSelfTest ° d ONLN d Í “< fi )<5 function to trigger the diagnostics test built into . ° d ONLN d fl ä Î œ ( Ë äthe camera curr å‡ ° d ONLN d. fl œ Î )Eently connected.
° d ONLN d \ * j € ( f * Retrieving and Capturing Images ˇˇˇˇˇˇ ( fÚ2
° d ONLN d ! q l } “ ( z lThe functions in this gr Œ ° d ONLN d 9 q “ } Ó )foup ar ë¿ ° d ONLN d ? q Ô } ) e used to r Å¿ ° d ONLN d J q }m ).etrieve and captur @ ° d ONLN d \ qn }ô )Q
e images.
≠ * ∂¯ 4 Æ * µ¯ Ø * Ø˛
ˇ·ˇ‚7^
° d ONLN d g † * Æ ± ( ™ *CmGetThumbnailImage ˇˇˇˇˇˇ ( ™Ú2 ,
Courier
. ° d ONLN d | ø l Àº ( » l8pascal OSErr CmGetThumbnailImage(CameraData cameraData, ° d ONLN d º Õ Í ŸÜ +~unsigned short pictureNo, ° d ONLN d fi € Í ÁÜ *BufferPtr thumbnailBuffer, ° d ONLN d È Í ı∂ *"unsigned long numberOfBytesToRead, ° d ONLN d* ˜ ÍV *Boolean firstRead, ° d ONLN dD Ín *LongPtr actualBytes); ° d ONLN d[ l) ® (& l
cameraData ° d ONLN df Æ) )BThe private data str l ° d ONLN dz )! )]uctur >` ° d ONLN d !), )e r ¿ ° d ONLN dÇ ,)] ) eturned by ¿ ° d ONLN dç ])• )1 CmOpenDriver ¿ ° d ONLN dô •)ÿ )H when your . ° d ONLN d§) Æ50 (2 Æ application opens the QuickT ‰` ° d ONLN d¿)/5å )Åake 100 device driver ‡ ° d ONLN d’)ç5í )^. . ° d ONLN dÿ9 lE ¢ (B l pictureNo . ° d ONLN d‚9 ÆEE )B!The number identifying the pictur hÄ ° d ONLN d9EE€ )ó!e whose thumbnail image is to be ° d ONLN d$E ÆQ ± (N Ær E ° d ONLN d%E ≤Q ÿ ) etrieved. . ° d ONLN d/U la Δ (^ lthumbnailBuffer ° d ONLN d>U Δa » )Z . ° d ONLN d@a Æm ≈ (j ÆAddr C¿ ° d ONLN dDa Δm ˙ )
ess of the ar s ° d ONLN dQa ˙m$ )4
ea to be fi “† ° d ONLN d\a$må )*lled with the data that r ≤Ä ° d ONLN duaåmö )hepr C@ ° d ONLN dxaõmı )esent the thumbnail ° d ONLN dåm Æy Œ (v Æimage. . ° d ONLN dî} lâ fi (Ü lnumberOfBytesToRead ° d ONLN d®â Æï7 +B Number of bytes of data to be r R` ° d ONLN d«â7ï^ )â ead into R` ° d ONLN d–â^ï∏ )'thumbnailBuffer ï ° d ONLN dflâ∑ïÒ )Y. This value . ° d ONLN dÌï Æ°c (û Æ*must be a multiple of 512 unless the entir ° d ONLN dïd°Ê )∂ e thumbnail is being transferr æ` ° d ONLN d5ïÊ°Û )Çed ° d ONLN d8° Æ≠fi (™ ÆKin a single call or the last block of data in a multiple-call sequence is r C` ° d ONLN dÉ°fl≠Û (™flead. . ° d ONLN dâ± lΩ ¢ (∫ l firstRead ° d ONLN dí± ¢Ω § )6 ° d ONLN dî± ÆΩ ∏ ) If ° d ONLN dó± ∏Ω – )
TRUE ° d ONLN dõ± –Ω3 ), uploads the image fr R` ° d ONLN d±±3ΩÑ )com the beginning. ° d ONLN dƒ¡ lÕ Æ ( l actualBytes . ° d ONLN d–Õ ÆŸ ≈ +B Addr C¿ ° d ONLN d‘Õ ΔŸ ˜ ) ess of an ar g ° d ONLN d‡Õ ˜Ÿj )1ea to which this function r «` ° d ONLN d˚ÕjŸ„ )seturns the number of bytes . ° d ONLN dŸ Æ € (‚ Æ
actually r R` ° d ONLN d Ÿ €Â )- ead into R` ° d ONLN d)ŸÂ\ )'thumbnailBuffer ï ° d ONLN d8Ÿ[Â` )Y.
. ° d ONLN d;ˇ * c ( * DESCRIPTION
ˇˇŸ" . ° d ONLN dG l +BThe ˇˇãf Y" ° d ONLN dK Ä Ú )CmGetThumbnailImage ˇˇŸ" Y" ° d ONLN d^ Ú )r function r ›Δ ° d ONLN di ˜ )+1etrieves the thumbnail version of the image of a . ° d ONLN dö l% ¥ (" lparticular pictur € ° d ONLN d´ ¥% √ )He. T ⁄Ä ° d ONLN dØ √% Ô ) o make pr C‡ ° d ONLN d∏ %! )- esenting pr ∑‡ ° d ONLN d√!%fi )1+eviews of an image in an application easier ÕÄ ° d ONLN dÓfi%Û )Ω, the ° d ONLN dÙ& l2 å (/ lQuickT ÄÄ ° d ONLN d˙& å2ı ) Qake 100 camera is capable of sending the host computer a miniaturized version of ° d ONLN dK3 l? ´ (< lthe image corr ‡ ° d ONLN dY3 ¨? )@esponding to a specifi j ° d ONLN do3 ?3 )` ed pictur 8¿ ° d ONLN dx34?Ê )(+e. This version of the image is called the ° d ONLN d£@ lL º (I lthumbnail image. . ° d ONLN dµR l^z *<The total number of bytes in a thumbnail image is 2400. The ° d ONLN dÒRz^Ï ([znumberOfBytesToRead ° d ONLN dRÏ^Ó )r . ° d ONLN d_ lk¿ (h lQparameter may be less than that. In this case, multiple calls to this function ar Ò ° d ONLN dV_¿kÙ (h¿ e necessary ° d ONLN dbl lx ¨ (u lto get the entir ª ° d ONLN drl ¨x )@e thumbnail image. 2Ä ° d ONLN dÑlx )V . ° d ONLN dÜ~ lä ˇ (á l When making multiple calls to r R` ° d ONLN d•~ ˇä≠ )ì'etrieve an image, the application sets R` ° d ONLN dÃ~≠ä„ )Æ firstRead R` ° d ONLN d’~„ä )6 to ˇˇÍ ° d ONLN dŸã ló Ñ (î lTRUE ˇˇ≠N ° d ONLN d›ã Ñó õ ) the f ´ ° d ONLN d„ã õóÿ )Lirst time the function is called on a particular image, and then sets it to ˇˇÍ “Æ ° d ONLN d/ãÿóˆ (îÿFALSE ˇˇ≠N “Æ ° d ONLN d4ãˆó˜ ) . ° d ONLN d5ò l§K (° l6for the subsequent calls to this function to get the r ‹ ° d ONLN dkòK§‰ )fl"emaining blocks of the image. The . ° d ONLN dç• l± v (Æ lar R` ° d ONLN dè• v± )
#ea pointed to by the last parameter ï ° d ONLN d≤•± )ü, ï ° d ONLN d¥•±\ ) actualBytes ï ° d ONLN dø•\±· )B , contains the number of bytes ° d ONLN dfi≤ læ Ω (ª lactually transferr R` ° d ONLN d≤ Ωæ ˛ )Qed into the buf $¿ ° d ONLN dˇ≤ ˛æJ )Afer pointed to by $¿ ° d ONLN d≤Jæ§ )LthumbnailBuffer g` ° d ONLN d ≤£æ¶ )Y. ˇ ‘ @ ˇ ˇˇˇˇ @
i ä u ± * It is the r h† ° d ONLN d i ± uä )'4esponsibility of the application to allocate the buf ⁄@ ° d ONLN d I iä u» )Ÿfer pointed to . ° d ONLN d X u ä Å ó ( ~ äby ,
Courier ° d ONLN d [ u ó Å Ò )
thumbnailBuffer ¬† ° d ONLN d j u Å ı )Y. ,
Zapf Dingbats
. ¬† ° d ONLN d m x ˙ Ä )
u
° d ONLN d o Ü ä íÎ ( è äPIf you plan to have your application upload the image in chunks of blocks, then ° d ONLN d ¿ ì ä üE *
ent $¿ ° d ONLN d7 †d ¨ö ) pictureNo $¿ ° d ONLN d@ †ö ¨ )6 parameter) in between ° d ONLN dW ≠ ä π ‹ ( ∂ äsuccessive calls to ° d ONLN dk ≠ ‹ πN )RCmGetThumbnailImage ° d ONLN d~ ≠N πÏ )r%. If you do make other calls on a dif R` ° d ONLN d£ ≠Ï π˘ )ûfer $¿ ° d ONLN d¶ ≠˘ π )
ent . ° d ONLN d™ ∫ ä Δ § ( √ äpictur È@ ° d ONLN d∞ ∫ § Δ ¯ )e, it causes the curr % ° d ONLN d≈ ∫ ˘ Δö )U$ent upload operation to terminate pr ¬ ° d ONLN dÈ ∫ö Δπ )°ematur n@ ° d ONLN dÔ ∫∫ Δ« ) ely ì† ° d ONLN dÚ ∫Δ ΔÓ )
, and the . ° d ONLN d¸ « ä ” ( – äapplication will have to r R` ° d ONLN d « ”Z )westart the upload fr $¿ ° d ONLN d* «Z ”¨ )Yom the beginning ( $¿ ° d ONLN d< «¨ ”Ù )R firstRead = $¿ ° d ONLN dH «Ù ” )HTRUE $¿ ° d ONLN dL « ” )). . ° d ONLN dO Ÿ ä  ( ‚ äVThe application is expected to know exactly how many times to call this function with ˇˇsË . ° d ONLN d• Ê ä Ú ± *
the appr ΔH ° d ONLN d≠ Ê ± Ú ı )'opriate size buf Äx ° d ONLN dΩ Ê ˆ Ú )E fer (see ˇ˛[∏ hH ° d ONLN dΔ Ê Úx )"CmGetPictureInfo ˇˇsË hH ° d ONLN d÷ Êx ÚÜ )`). T ˆ0 ° d ONLN d⁄ ÊÖ Ú¨ )
rying to r ∞` ° d ONLN d‰ Ê≠ Ú )(ead image data beyond . ° d ONLN d˙ Û ä ˇ ( ¸ ä#the actual size of the image will r ˇÄ ° d ONLN d Û ˇW )ëesult in an err ƒ` ° d ONLN d, ÛX ˇa )=or o ° d ONLN d. Ûa ˇf ) . ˇˇ≤D . ° d ONLN d1 ä ù ( äThe ˇˇÃ 2D ° d ONLN d5 û )CmGetThumbnailImage ˇˇ≤D 2D ° d ONLN dH` )r function does not r Õ¥ ° d ONLN d\`∞ )Peturn until it has r i$ ° d ONLN dp± )Qetrieved the specifi Õ¨ ° d ONLN dÑ )Xed . ° d ONLN dá ä ( änumber of bytes or it has fi GÄ ° d ONLN d£  )w4nished. If you want your application to pursue a dif ø ° d ONLN d◊Â Ò )‰fer °Ä ° d ONLN d⁄Ò ) ent ° d ONLN dfi ä+ ó (( äthr X¿ ° d ONLN d· ó+ )
ead of execution while r 4 ° d ONLN d˘ +∫ )j*etrieving thumbnail data, you should call . ° d ONLN d#, ä8 (5 äCmGetThumbnailImageAsync ° d ONLN d;,8K )ê instead of ° d ONLN dG,K8Ω )1CmGetThumbnailImage ° d ONLN dZ,Ω8¿ )r. . ° d ONLN d\> äJù (G ä=For information about decoding the data format of the image r 7¿ ° d ONLN dô>ûJ
(Gûeturned by this function, . ° d ONLN d≥K äW ¨ (T äsee the ° d ONLN dªK ¨W )"CmGetDecompTable ° d ONLN dÀK Wm )` function described on ° d ONLN d‚KmWÖ )apage ° d ONLN dÁKÖWò )2-45 ° d ONLN dÎKòWø ) and the ° d ONLN dÙX äd& (a äCmGetColorCorrectionMatrix ° d ONLN dX&dá )ú function described on ° d ONLN d%Xádü )apage ° d ONLN d*Xüd≤ )2-46 ° d ONLN d.X≤dµ ).
. ° d ONLN d0~ Há b (Ö HRESUL ëÄ ° d ONLN d5~ bá Ü )T CODES
. ° d ONLN d=å äò +( Upon successful completion, the ° d ONLN d]åòå )êCmGetThumbnailImage ° d ONLN dpååò∏ )r function r R` ° d ONLN d{å∏ò’ ),eturns R` ° d ONLN dÇå’òÛ ) noErr ï ° d ONLN dáåÚò
. ° d ONLN d j l v à +BCmGetPictureInfo ° d ONLN d j à v ⁄ )` on ° d ONLN d j ⁄ v Ú )page ° d ONLN d " j Ú v )2-29 ° d ONLN d & j v
); ° d ONLN d ( j
vv )CmGetFullSizeImage ° d ONLN d : jv vÑ )l on ° d ONLN d > jÑ vú )page ° d ONLN d C jú vØ )2-57 ° d ONLN d G jØ v¥ ); ° d ONLN d I w l É ¸ ( Ä lCmGetThumbnailImageAsync ° d ONLN d a w ¸ ÉF )ê, described next; ° d ONLN d s wF Éö )JCmGetErrorInfo ° d ONLN d Å wö É® )T on ° d ONLN d Ö w® É¿ )page ° d ONLN d ä w¿ É” )2-48 ° d ONLN d é w” É’ )
≥ * º¯ 4 ¥ * ª¯ µ * µ˛
ˇ·ˇ‚7^
. ° d ONLN d ê ¶ * ¥ ” ( ∞ *CmGetThumbnailImageAsync ˇˇˇˇˇˇ ( ∞Ú2
. ° d ONLN d ™ ≈ l —J ( Œ l%pascal OSErr CmGetThumbnailImageAsync ° d ONLN d ‘ ” ¥ fl> +H(CameraData cameraData, ° d ONLN d · ¥ ÌJ *unsigned short pictureNo, ° d ONLN d Ô ¥ ˚P *BufferPtr thumbnailBuffer, ° d ONLN d- ˝ ¥ Ä *"unsigned long numberOfBytesToRead, ° d ONLN dT ¥ *Boolean firstRead, ° d ONLN dk ¥%Ú *5CmAsyncCompletionRoutinePtr asyncCompletionRoutine); ° d ONLN d°1 l= ® (: l
cameraData ° d ONLN d¨1 Æ= )BThe private data str l ° d ONLN d¿1 =! )]uctur >` ° d ONLN d≈1!=, )e r ¿ ° d ONLN d»1,=] ) eturned by ¿ ° d ONLN d”1]=• )1 CmOpenDriver ¿ ° d ONLN dfl1•=ÿ )H when your . ° d ONLN dÍ= ÆI0 (F Æ application opens the QuickT ‰` ° d ONLN d=/Iå )Åake 100 device driver ‡ ° d ONLN d=çIí )^. . ° d ONLN d M lY ¢ (V l pictureNo . ° d ONLN d(M ÆYE )B!The number identifying the pictur hÄ ° d ONLN dIMEY€ )ó!e whose thumbnail image is to be ° d ONLN djY Æe ⁄ (b Æ uploaded. . ° d ONLN dti lu Δ (r lthumbnailBuffer . ° d ONLN dÑu ÆÅ ≈ +B Addr C¿ ° d ONLN dàu ΔÅ )ess of a data ar s‡ ° d ONLN dòuÅ1 )A
ea to be fi ”` ° d ONLN d£u1Åô )*lled with the data that r ≥@ ° d ONLN dºuôÅß )hepr D ° d ONLN døu®Å— )
TRUE ° d ONLN dfl≈ –— ), upload starts fr R` ° d ONLN dÒ≈—¬ )K$om the beginning of the image specifi R` ° d ONLN d≈¬—– )ßed. ° d ONLN d’ l· (fi lasyncCompletionRoutine . ° d ONLN d1· ÆÌ ≈ +B Addr C¿ ° d ONLN d5· ΔÌË )Dess of a callback function to be called by the driver when the data ° d ONLN dyÌ Æ˘ (ˆ Ætransfer is complete.
° d ONLN dè * c ( * DESCRIPTION
. ° d ONLN dõ l, Ä +BThe ° d ONLN dü Ä, )CmGetThumbnailImageAsync ° d ONLN d∑ ,x )ê function is the asynchr R` ° d ONLN dœ x,¿ )honous version of ° d ONLN d‡- l9 fi (6 lCmGetThumbnailImage ° d ONLN dÛ- fi9 )r
and is pr R` ° d ONLN d˝-9C )) ovided for W ≈¿ ° d ONLN d -B9Ò );&indows applications that pursue other . ° d ONLN d/: lFÑ (C l@activities during the time in which a thumbnail image is being r Ä ° d ONLN do:ÖF≥ (CÖ etrieved fr Ú† ° d ONLN dz:≤F” )-om the ˇˇŸ" . ° d ONLN dÅG lS  (P lcamera. The parameters ar ›Δ ° d ONLN döG ÂSÉ )y$e the same as those supplied to the ˇˇãf ¶÷ ° d ONLN dæGÑSˆ )üCmGetThumbnailImage ˇˇŸ" ¶÷ ° d ONLN d—GˆS˜ )r . ° d ONLN d“T l` (] l'function, except for the last parameter ”† ° d ONLN d˘T`a )ß, which is an addr ô@ ° d ONLN d Tb`Í )O!ess of a callback function to be . ° d ONLN d,a lmY (j l4called when the total number of bytes of data specifi ° d ONLN daaYmq )Ìed in ° d ONLN dgaqm„ )numberOfBytesToRead ° d ONLN dza„m¯ )r has ° d ONLN dn lz ™ (w lbeen transferr R` ° d ONLN dçn ™z8 )>!ed to the location pointed to by R` ° d ONLN dÆn8zí )éthumbnailBuffer ï ° d ONLN dΩnëz¨ )Y. (See ° d ONLN dƒ{ lá ¸ (Ñ lCmAsyncCompletionRoutine ° d ONLN d‹{ ¸á
)ê on ° d ONLN d‡{
á" )page ° d ONLN dÂ{"á5 )2-33 ° d ONLN dÈ{5á‘ )$ for information about the callback . ° d ONLN d
à lî ô (ë l function.) ° d ONLN dö l¶ î *The addr ∏@ ° d ONLN d!ö î¶ È )(ess of the callback r /† ° d ONLN d6ö Ͷæ )V0outine handed to this function must be the one r Û¿ ° d ONLN dföæ¶ )‘ eturned by . ° d ONLN dqß l≥ â (∞ lthe W Û` ° d ONLN dvß à≥ – ) indows function Û` ° d ONLN dÜß –≥0 )HMakeProcInstance Û` ° d ONLN dñß0≥5 )`. ˇR @ ˇ ˇˇˇˇ @
Courier ° d ONLN d> ™ û ∂. )CmGetThumbnailImageAsync ° d ONLN dV ™. ∂≥ )ê function is valid only for the . ° d ONLN dv ∂ ä ¬ î ( ø äW Û` ° d ONLN dw ∂ ì ¬ ‚ ) indows platform. ,
Zapf Dingbats
@ ° d ONLN dâ π Ë ¡ Ô )Us ° d ONLN dã € H ‰ b ( ‚ HRESUL ëÄ ° d ONLN dê € b ‰ Ü )T CODES
The QuickT º@ ° d ONLN dtbïn )3 ake 100 driver has not been ° d ONLN dêmbyì (vb
initialized.
° d ONLN dûë Hö o (ò HSEE ALSO
. ° d ONLN dßü ä´ +BCmAsyncCompletionRoutine ° d ONLN døü´( )ê on ° d ONLN d√ü(´@ )page ° d ONLN d»ü@´S )2-33 ° d ONLN dÃüS´X ), ° d ONLN dŒüX´‹ )CmCancelAsyncOperation ° d ONLN d‰ü‹´Í )Ñ on ° d ONLN d˨ ä∏ ¢ (µ äpage ° d ONLN d̨ ¢∏ µ )2-34 ° d ONLN dÒ¨ µ∏ ∫ ), ° d ONLN dÛ¨ ∫∏, )CmGetThumbnailImage ° d ONLN d¨,∏: )r on ° d ONLN d
¨:∏R )page ° d ONLN d¨R∏e )2-54 ° d ONLN d¨e∏j ), ° d ONLN d¨j∏Ù )CmGetFullSizeImageAsync ° d ONLN d,¨Ù∏ )ä on ° d ONLN d0π ä≈ ¢ (¬ äpage ° d ONLN d5π ¢≈ µ )2-60 ° d ONLN d9π µ≈ ∫ ), ° d ONLN d;π ∫≈ )CmGetDecompTable ° d ONLN dKπ≈( )` on ° d ONLN dOπ(≈@ )page ° d ONLN dTπ@≈S )2-45 ° d ONLN dXπS≈X ), ° d ONLN dZπX≈Ù )CmGetColorCorrectionMatrix ° d ONLN dtπÙ≈ )ú on ° d ONLN dxΔ ä“ ¢ (œ äpage ° d ONLN d}Δ ¢“ µ )2-46 ° d ONLN dÅΔ µ“ ∫ ), ° d ONLN dÉΔ ∫“ )CmGetErrorInfo ° d ONLN dëΔ“ )T on ° d ONLN dïΔ “4 )page ° d ONLN döΔ4“G )2-48 ° d ONLN dûΔG“I )
H 4 H
H
ˇ·ˇ‚7^
. ° d ONLN d†ı H æ (ˇ HCmGetFullSizeImage ˇˇˇˇˇˇ (ˇ2
. ° d ONLN d¥ ä Œ ( ä6pascal OSErr CmGetFullSizeImage(CameraData cameraData, ° d ONLN dÚ".û +~unsigned short pictureNo, ° d ONLN d0<å *BufferPtr imageBuffer, ° d ONLN d1>J‘ *"unsigned long numberOfBytesToRead, ° d ONLN d[LXt *Boolean firstRead, ° d ONLN duZfí *LongPtr actualBytes); ° d ONLN dçr ä~ Δ ({ ä
cameraData ° d ONLN dòr Ã~) )BThe private data str l ° d ONLN d¨r)~? )]uctur >` ° d ONLN d±r?~J )e r ¿ ° d ONLN d¥rJ~{ ) eturned by ¿ ° d ONLN dør{~√ )1 CmOpenDriver ¿ ° d ONLN dÀr√~ˆ )H when your . ° d ONLN d÷~ ÃäN (á Ã application opens the QuickT ‰` ° d ONLN dÚ~Mä™ )Åake 100 device driver ‡ ° d ONLN d~´ä∞ )^. . ° d ONLN d
é äö ¿ (ó ä pictureNo . ° d ONLN dé Ãöc )B!The number identifying the pictur hÄ ° d ONLN d5écöÓ )ó!e whose full-size image is to be ° d ONLN dVö ö ˚ (£ Ã
. ° d ONLN d \ l h Æ ( e l imageBuffer . ° d ONLN d h Æ t ≈ +B Addr C¿ ° d ONLN d h Δ t )ess of the buf c ° d ONLN d h tg ):fer into which data corr 2¿ ° d ONLN d 6 hh tÙ )h esponding to the image is to be ° d ONLN d V t Æ Ä æ ( } Æstor 9‡ ° d ONLN d Z t ø Ä Ã )ed. . ° d ONLN d ^ Ñ l ê fi ( ç lnumberOfBytesToRead ° d ONLN d r ê Æ úk +B +The number of bytes of data to be transferr R` ° d ONLN d ù êk úÉ )Ωed to R` ° d ONLN d £ êÉ ú≈ ) imageBuffer ï ° d ONLN d Æ êƒ ú‡ )A. This . ° d ONLN d µ ú Æ ®~ ( • Æ0value must be a multiple of 512 unless the entir „Ä ° d ONLN d  ú~ ®« )–e image is being ° d ONLN d ˆ ® Æ ¥ ‘ ( ± Æ transferr òÄ ° d ONLN d ˇ ® ‘ ¥ı )&Fed in a single call or when the last block of data in a multiple-call ° d ONLN dE ¥ Æ ¿ Ê ( Ω Æ
sequence is r Ê ° d ONLN dR ¥ Ê ¿ ˙ )8ead. . ° d ONLN dX ƒ l – ¢ ( Õ l firstRead ° d ONLN db ƒ Æ – ∫ )B If ° d ONLN df ƒ ∫ – “ ) TRUE ° d ONLN dj ƒ “ –! ), data is transferr R` ° d ONLN d} ƒ! –c )Oed beginning fr $¿ ° d ONLN då ƒc –ÿ )Bom the start of the image. ° d ONLN dß ‘ l ‡ Æ ( › l actualBytes . ° d ONLN d≥ ‡ Æ Ï ≈ +B Addr C¿ ° d ONLN d∑ ‡ Δ Ïˆ )Dess of a memory location into which this function writes the number . ° d ONLN d˚ Ï Æ ¯$ ( ı Æof bytes actually transferr R` ° d ONLN d Ï$ ¯E )ved into R` ° d ONLN d ÏE ¯á )! imageBuffer ï ° d ONLN d) ÏÜ ¯â )A.
*¯ 4 *¯
. ° d ONLN d+ l ( lNote
ˇ·ˇ‚7^
. ° d ONLN d0 l w *W Û` ° d ONLN d1 v ' )
'indows applications should not use the Û` ° d ONLN dX' ] )± BufferPtr Û` ° d ONLN da] ó )6 type for the ° d ONLN do l) Æ (& l imageBuffer ° d ONLN dz Æ) )B parameter as it is def PÄ ° d ONLN dë )3 )cined on PÄ ° d ONLN dô 3)K )"page PÄ ° d ONLN dû K)Y )2-9 PÄ ° d ONLN d° Y)¢ ) when making a ° d ONLN d∞) l5 ù (2 l call to the ° d ONLN dº) ù5 )1CmGetFullSizeImage ° d ONLN dŒ) 5¢ )l% function, if the number of bytes to . ° d ONLN dÛ5 lA o (> lr E ° d ONLN dÙ5 pA µ )ead into the buf Æ` ° d ONLN d5 µA « )Efer r Ä ° d ONLN d 5 »A fl )equir ¿ ° d ONLN d5 flA< )ed for the image is gr ® ° d ONLN d$5<Aà )]eater than 64,000 ° d ONLN d6A lM ä (J l(high-r ° d ONLN d=A ãM ‹ ) esolution images r ˚` ° d ONLN dOA €M Ú )Pequir † ° d ONLN dTA ÛM ˇ )e 1 œ† ° d ONLN dWA ˛Mà ) !15,200 bytes). Instead, use type . ° d ONLN dxM lY ~ (V lcoer R` ° d ONLN d|M ~Y ) cion to change the type of the R` ° d ONLN dõMYG )á imageBuffer R` ° d ONLN d¶MGYÜ )B parameter to ° d ONLN d¥Y le fi (b lunsigned char huge* ° d ONLN d«Y fie · )r. ,
Zapf Dingbats
. ° d ONLN d…\ Êd Ï )u
. Œ ° d ONLN d Y Ïe Ó )
. ° d ONLN dÃ~ *á c (Ö * DESCRIPTION
. ° d ONLN dÿå lò Ä +BThe ° d ONLN d‹å Äò Ï )CmGetFullSizeImage ° d ONLN dÓå Ïò )l function r R` ° d ONLN d˘åò– ),*etrieves the full-size image of the pictur $¿ ° d ONLN d#å–òÙ )∏ e in the . ° d ONLN d,ô l• é (¢ lcamera. Ä ° d ONLN d3ô è• ë )# ° d ONLN d5´ l∑ r (¥ lY @Ä ° d ONLN d6´ r∑Ö )<our application may allocate enough memory to hold the entir X@ ° d ONLN dr´Ö∑“ (¥Öe amount of data . ° d ONLN dÉ∏ lƒ Í (¡ l comprising the image to be r R` ° d ONLN dü∏ ̓] )~ etrieved. In this case, set R` ° d ONLN dª∏]ƒœ )snumberOfBytesToRead R` ° d ONLN dŒ∏œƒÓ )r to the ˇˇ}, ° d ONLN d÷≈ l— (Œ l)actual number of bytes of the image (see ˇ˛wÑ i` ° d ONLN dˇ≈ —} )±CmGetPictureInfo ˇˇ}, i` ° d ONLN d≈}—Æ )` ). The entir 6 ° d ONLN d≈Ø—– )2e data r – ° d ONLN d#≈——¯ )" etrieval . ° d ONLN d,“ lfi u (€ lpr G ° d ONLN d.“ vfi ï )
ocess fi ˝@ ° d ONLN d6“ ïfiC ) *nishes with a single call to the function. . ° d ONLN da‰ l ñ (Ì lHowever ¬† ° d ONLN dh‰ ï. ))#, if host memory is in short supply ¶‡ ° d ONLN dã‰-2 )ò, ¶‡ ° d ONLN dç‰2§ )numberOfBytesToRead ¶‡ ° d ONLN d†‰§ı )r may be set to less . ° d ONLN d¥Ò l˝Ò (˙ l[than the actual number of bytes comprising the image. In this case, multiple calls to this ° d ONLN d˛ l
ú *
function ar ”@ ° d ONLN d˛ ú
Z )0,e necessary to upload all of the image data. . ° d ONLN dG l r ( lT ï ° d ONLN dH q ‡ )o make multiple calls to ï ° d ONLN da ‡ L )oCmGetFullSizeImage ï ° d ONLN dsL ` )l, set ï ° d ONLN dy` ñ ) firstRead ï ° d ONLN dÇñ £ )6 to ï ° d ONLN dÜ£ ª )
TRUE ï ° d ONLN däª · ) in the fi ï ° d ONLN dî· Ô )&rst ° d ONLN dò l)b (& l9call to the function on a particular image, and then set ° d ONLN d— b)ò )ˆ firstRead ° d ONLN d⁄ ò)• )6 to ° d ONLN dfi •)√ )
FALSE ° d ONLN d„ √)Ê ) for the . ° d ONLN dÏ* l6 Ê (3 l subsequent calls to get the r √` ° d ONLN d * Ê6à )z$emaining blocks of the image. The ar B ° d ONLN d-*â6ı )£ea pointed to by the last . ° d ONLN dG7 lC ú (@ l parameter ¬† ° d ONLN dP7 õC † )/, ¬† ° d ONLN dR7 †C ‚ ) actualBytes ¬† ° d ONLN d]7 ‚C∏ )B1, contains the number of bytes actually transferr ï ° d ONLN dé7∏CÎ )÷ ed into the ° d ONLN döD lP z (M lbuf R` ° d ONLN dùD zP Δ )fer pointed to by R` ° d ONLN dØD ΔP )L imageBuffer ï ° d ONLN d∫DP
)A. . ° d ONLN dºV lb (_ l=For information about decoding the data format of the image r 7¿ ° d ONLN d˘VÄb≈ (_Äeturned by this . ° d ONLN d
c lo ∑ (l lfunction, see the ° d ONLN d c ∑o )KCmGetDecompTable ° d ONLN d,cox )` function described on ° d ONLN dCcxoê )apage ° d ONLN dHcêo£ )2-45 ° d ONLN dLc£o∫ ), the ° d ONLN dRp l| (y lCmGetColorCorrectionMatrix ° d ONLN dlp|i )ú function described on ° d ONLN dÉpi|Å )apage ° d ONLN dàpÅ|î )2-46 ° d ONLN dåpî|´ ), the ° d ONLN dí} lâ Í (Ü lIpGetCompressionTable ° d ONLN dß} ÍâK )~ function described on ° d ONLN dæ}Kâc )apage ° d ONLN d√}câv )4-18 ° d ONLN d«}vâç ), the ° d ONLN dÕä lñ Í (ì lIpSetCompressionTable ° d ONLN d‚ä ÍñK )~ function described on ° d ONLN d˘äKñc )apage ° d ONLN d˛äcñv )4-19 ° d ONLN d ävñ† )
, and the ° d ONLN d ó l£ († lIpInitCompressionTable ° d ONLN d "ó £Q )Ñ function described on ° d ONLN d 9óQ£i )apage ° d ONLN d >ói£w )4-9 ° d ONLN d Aów£z ). ˇ H @ ˇ ˇˇˇˇ @
, (‡2-59 4 ^ H¿ ° d ONLN d \ ä h ± ( e ä It is the r h† ° d ONLN d \ ± hë )'5esponsibility of your application to allocate the buf ˚@ ° d ONLN d @ \ë h› )‡fer pointed to by ,
Courier . ° d ONLN d R i ä u à ( r ä imageBuffer ¬† ° d ONLN d ] i À u Œ )A.
É H ë 4 Ñ H ë
. ° d ONLN d _ Ç ä ç ù ( ä äNote
ˇ·ˇ‚7^
° d ONLN d d è ä õ« *IIf your application uploads the image in chunks of blocks, it should not ° d ONLN d ≠ õ ä ß ˇ * attempt to call any QuickT @¿ ° d ONLN d « õ ˇ ß™ )u(ake 100 driver function (including this ° d ONLN d Ô ß ä ≥ ” ( ∞ äfunction on a dif Ä ° d ONLN d ß ” ≥ fl )Ifer b ° d ONLN d ß fl ≥ )
ent pictur († ° d ONLN d
ß
≥ô )+"e) in between successive calls to ˇˇ√d . ° d ONLN d/ ≥ ä ø ˆ ( º äCmGetFullSizeImage ˇˇÎà ° d ONLN dA ≥ ˆ ø ˙ )l.
l ° d ONLN dC ≥ ˚ øŒ )/Any attempt at calling another function causes . ° d ONLN dr ø ä À ¨ ( » äthe curr ` ° d ONLN dz ø ≠ À ¡ )#ent r .¿ ° d ONLN d ø ¡ À: ) etrieval operation to end pr I@ ° d ONLN dõ ø: ÀY )yematur ı` ° d ONLN d° øY À£ ) ely and makes it . ° d ONLN d≤ À ä ◊ Δ ( ‘ änecessary to r R` ° d ONLN d¿ À Δ ◊ ˇ )<
estart the pr $¿ ° d ONLN dÕ À ˇ ◊ )9ocess fr ˜ ° d ONLN d’ À ◊p ) om the beginning ( ˜ ° d ONLN dÁ Àp ◊∏ )R firstRead = ° d ONLN dÛ ◊ ä „ ¢ ( ‡ äTRUE ° d ONLN d˜ ◊ ¢ „ ´ )). . ° d ONLN d˚ Ë ä ÙÕ ( Ò äHThe application is expected to know exactly how many times it must call . ° d ONLN dC Ù ä ˆ * CmGetFullSizeImage ° d ONLN dU Ù ˆ H )l and with how lar R` ° d ONLN df ÙH j )Rge a buf $¿ ° d ONLN dn Ùj w )"fer g` ° d ONLN dq Ùv { ) . ° d ONLN ds Ù{ Ω )Attempting to . ° d ONLN dÅ ä ç ( är E ° d ONLN dÇ é n )3ead image data beyond the actual size of the data r ° d ONLN dµ n Ø )‡esults in an err ‡ ° d ONLN d≈ Ø ∏ )Aor ≈† ° d ONLN d« ∑ º ). . ° d ONLN d ä û ( äThe ° d ONLN dŒ û
)CmGetFullSizeImage ° d ONLN d‡
\ )l function does not r R` ° d ONLN dÙ\ )Return to the application . ° d ONLN d
ä) ø (& äuntil it has r È¿ ° d ONLN d ø) )5etrieved the specifi qÄ ° d ONLN d/ )ó )T ed number of bytes or it has fi û` ° d ONLN dN ó)π )Ñnished. ,
Zapf Dingbats
K‡ ° d ONLN dW ø(≈ )(u
° d ONLN dY. ä:K (7 ä,If you want your application to pursue a dif J ° d ONLN dÖ.L:X )¬fer ,Ä ° d ONLN dà.X:u ) ent thr b† ° d ONLN dè.u:Ò ) ead of execution during the ˇˇè4 . ° d ONLN d´; äG é (D är R` ° d ONLN d¨; éG ø ) etrieval pr ≥Ù ° d ONLN d∑; øG Ì )1 ocess, call ˇ˛≠ú “\ ° d ONLN d√; ÌGw ).CmGetFullSizeImageAsync ˇˇè4 “\ ° d ONLN d⁄;wG¶ )ä instead of ˇ˛≠ú ¯ ° d ONLN dÊ;ßG )0CmGetFullSizeImage ˇˇè4 ¯ ° d ONLN d¯;G )l.
. ° d ONLN d˙a Hj b (h HRESUL ëÄ ° d ONLN dˇa bj Ü )T CODES
ê¶ )CmGetColorCorrectionMatrix ° d ONLN d … Ѷ ê¥ )ú on ° d ONLN d Õ Ñ¥ êà )page ° d ONLN d “ Ñà êfl )2-46 ° d ONLN d ÷ Ñfl ê‰ ); ° d ONLN d ÿ ë l ù ¿ ( ö lCmGetErrorInfo ° d ONLN d Ê ë ¿ ù Œ )T on ° d ONLN d Í ë Œ ù Ê )page ° d ONLN d Ô ë Ê ù ˘ )2-48 ° d ONLN d Û ë ˘ ù ˚ )
Õ * ÷¯ 4 Œ * ’¯ œ * œ˛
ˇ·ˇ‚7^
. ° d ONLN d ı ¿ * Œ ¬ ( *CmGetFullSizeImageAsync ˇˇˇˇˇˇ ( Ú2
. ° d ONLN d fl l ÎŒ ( Ë l;pascal OSErr CmGetFullSizeImageAsync(CameraData cameraData, ° d ONLN dN Ì ¥ ˘J +Hunsigned short pictureNo, ° d ONLN dl ˚ ¥8 *BufferPtr imageBuffer, ° d ONLN dá ¥Ä *"unsigned long numberOfBytesToRead, ° d ONLN dÆ ¥# *Boolean firstRead, ° d ONLN d≈% ¥1Ú *5CmAsyncCompletionRoutinePtr asyncCompletionRoutine); ° d ONLN d˚= lI ® (F l
cameraData ° d ONLN d= ÆI )BThe private data str l ° d ONLN d= I! )]uctur >` ° d ONLN d =!I, )e r ¿ ° d ONLN d"=,I] ) eturned by ¿ ° d ONLN d-=]I• )1 CmOpenDriver ¿ ° d ONLN d9=•Iÿ )H when your . ° d ONLN dDI ÆU0 (R Æ application opens the QuickT ‰` ° d ONLN d`I/Uå )Åake 100 device driver ‡ ° d ONLN duIçUí )^. . ° d ONLN dxY le ¢ (b l pictureNo . ° d ONLN dÇY ÆeE )B!The number identifying the pictur hÄ ° d ONLN d£YEe– )ó!e whose full-size image is to be ° d ONLN dƒe Æq › (n Æ
sequence is r Ê ° d ONLN d!Õ ÊŸ ˙ )8ead. . ° d ONLN d'› lÈ ¢ (Ê l firstRead ° d ONLN d1› ÆÈ ∏ )BIf ° d ONLN d4› ∏È – )
TRUE ° d ONLN d8› –È ), data is transferr R` ° d ONLN dK› Èa )Oed beginning fr $¿ ° d ONLN dZ›aÈ÷ )Bom the start of the image. ° d ONLN duÌ l˘ (ˆ lasyncCompletionRoutine . ° d ONLN då˘ Æ ≈ +B Addr C¿ ° d ONLN dê˘ Δ≥ )7ess of a callback function to be called when the specifi e` ° d ONLN d»˘≥Ò )Ì
ed number of . ° d ONLN d’ Æ ( Æbytes has been transferr R` ° d ONLN dÌQ )k
ed to the buf $¿ ° d ONLN d˙Qù )8fer pointed to by $¿ ° d ONLN d ùfl )L imageBuffer g` ° d ONLN dfi· )A.
. ° d ONLN d+ *4 c (2 * DESCRIPTION
. ° d ONLN d%8 lD Ä +BThe ° d ONLN d)8 ÄD
)CmGetFullSizeImageAsync ° d ONLN d@8
Dr )ä function is the asynchr R` ° d ONLN dX8rD∫ )honous version of ° d ONLN diE lQ ÿ (N lCmGetFullSizeImage ° d ONLN d{E ÿQ )l
and is pr R` ° d ONLN dÖEQ= )) ovided for W ≈¿ ° d ONLN dëE<Qÿ );"indows applications that pursue a . ° d ONLN d≥R l^ x ([ ldif ™` ° d ONLN d∂R x^ Ñ ) fer å‡ ° d ONLN dπR Ñ^ ° ) ent thr √ ° d ONLN d¿R °^e ) ,ead of execution during the time the image r “@ ° d ONLN dÏRe^í )ƒ etrieval pr X† ° d ONLN d˜Rì^Ó ).ocess is taking place. . ° d ONLN dd lp ¿ (m lThe parameters ar R` ° d ONLN d d ¿p` )T$e the same as those supplied to the R` ° d ONLN dCd`pà )†CmGetFullSizeImage R` ° d ONLN dUdÃpÙ )l
function ° d ONLN d_q l} (z l except for the last parameter ¬† ° d ONLN d|q Ô} Ù )É, ¬† ° d ONLN d~q Ù}x )asyncCompletionRoutine ¬† ° d ONLN dîqx}œ )Ñ, which is the addr ï ° d ONLN dßqœ}Ò )W ess of a . ° d ONLN d∞~ lä ñ (á l
callback r ç ° d ONLN d∫~ ñä- )*$outine to be called after the specifi ú‡ ° d ONLN dfl~-ä⁄ )ó&ed number of bytes have been transferr ·¿ ° d ONLN d~⁄äÚ )≠ed to . ° d ONLN d ã ló (î l"the memory location pointed to by ° d ONLN d-ãóJ )ú imageBuffer ¬† ° d ONLN d8ãIód )A. (See ¬† ° d ONLN d?ãdóÙ )CmAsyncCompletionRoutine ¬† ° d ONLN dWãÙóˆ )ê . ° d ONLN dXò l§ y (° lon F‡ ° d ONLN d[ò z§ ë )page !¿ ° d ONLN d`ò í§ § )2-33 u† ° d ONLN ddò §§ ¨ ).) ˇÇ @ ˇ ˇˇˇˇ @
, (‡2-61 4 ^ H¿ ° d ONLN d \ ä h • ( e äFor W j† ° d ONLN d \ • h( ) indows applications, the addr ` ° d ONLN d " \) h~ )Ñess of the callback r é¿ ° d ONLN d 7 \~ h )U outine handed to this function . ° d ONLN d V i ä u ‘ ( r ämust be the one r R` ° d ONLN d g i ‘ u" )Jeturned by the W ≈¿ ° d ONLN d w i! ui )Mindows function ,
Courier ≈¿ ° d ONLN d á ii u… )HMakeProcInstance ≈¿ ° d ONLN d ó i… uà )`.
° d ONLN d £ è ä õ ê ( ò äY @Ä ° d ONLN d § è ê õô )<our application should not attempt to call any of the QuickT ÊÄ ° d ONLN d ‡ èò õª ( òòake 100 ° d ONLN d Ë õ ä ß∞ ( § äFdriver functions (including this function) prior to the time that the ° d ONLN d. ß ä ≥ ™ * QuickT ÄÄ ° d ONLN d4 ß ™ ≥B ) $ake 100 driver calls your callback r ;‡ ° d ONLN dX ßC ≥a )ôoutine. ° d ONLN d` ∏ ä ƒµ ( ¡ äDLikewise, you should not attempt to issue calls to any of the QuickT VÄ ° d ONLN d§ ∏µ ƒΔ ( ¡µake ° d ONLN d® ƒ ä –í ( Õ ä=100 driver functions (except this function) while the image r ~Ä ° d ONLN d ƒí –µ ( Õí etrieval ° d ONLN dÓ – ä ‹ ì ( Ÿ äpr G ° d ONLN d – î ‹ Ú )
ocess is taking place. ,
Zapf Dingbats
T† ° d ONLN d ” ˜ € ˛ )cs
. ° d ONLN d
· ä Ì û ( Í äThe ° d ONLN d · û Ì( )CmGetFullSizeImageAsync ° d ONLN d% ·( Ì∏ )ä! function is valid only for the W Û` ° d ONLN dF ·∑ Ì )èindows platform.
. ° d ONLN dW H b ( HRESUL ëÄ ° d ONLN d\ b Ü )T CODES
. ° d ONLN dd ä! +( Upon successful completion, the ° d ONLN dÑ!§ )êCmGetFullSizeImageAsync ° d ONLN dõ§!– )ä function r R` ° d ONLN d¶–!Ì ),eturns R` ° d ONLN d≠Ì! ) noErr ï ° d ONLN d≤
The QuickT º@ ° d ONLN dGÅïç )3 ake 100 driver has not been ° d ONLN dcåbòì (ïb
initialized.
° d ONLN dq∞ Hπ o (∑ HSEE ALSO
. ° d ONLN dzæ ä +BCmAsyncCompletionRoutine ° d ONLN díæ ( )ê on ° d ONLN dñæ( @ )page ° d ONLN dõæ@ S )2-33 ° d ONLN düæS X ), ° d ONLN d°æX ‹ )CmCancelAsyncOperation ° d ONLN d∑æ‹ Í )Ñ on ° d ONLN dªÀ ä◊ ¢ (‘ äpage ° d ONLN d¿À ¢◊ µ )2-34 ° d ONLN dƒÀ µ◊ ∫ ), ° d ONLN dΔÀ ∫◊& )CmGetFullSizeImage ° d ONLN dÿÀ&◊4 )l on ° d ONLN d‹À4◊L )page ° d ONLN d·ÀL◊_ )2-57 ° d ONLN dÂÀ_◊d ), ° d ONLN dÁÀd◊Ù )CmGetThumbnailImageAsync ° d ONLN dˇÀÙ◊ )ê on ° d ONLN dÿ ä‰ ¢ (· äpage ° d ONLN dÿ ¢‰ µ )2-56 ° d ONLN d ÿ µ‰ ∫ ), ° d ONLN dÿ ∫‰ )CmGetErrorInfo ° d ONLN d ÿ‰ )T on ° d ONLN d ÿ ‰4 )page ° d ONLN d%ÿ4‰G )2-48 ° d ONLN d)ÿG‰I )
H 4 H H
ˇ·ˇ‚7^
. ° d ONLN d+ H c ( HCmT Å ° d ONLN d. b õ )
akePicture ˇˇˇˇˇˇ (2
. ° d ONLN d:& ä2∂ (/ ä2pascal OSErr CmTakePicture(CameraData cameraData, ° d ONLN du4@Ä +êBoolean timerOn); ° d ONLN dáL äX Δ (U ä
cameraData ° d ONLN díL ÃX) )BThe private data str l ° d ONLN d¶L)X? )]uctur >` ° d ONLN d´L?XJ )e r ¿ ° d ONLN dÆLJX{ ) eturned by ¿ ° d ONLN dπL{X√ )1 CmOpenDriver ¿ ° d ONLN d≈L√Xˆ )H when your . ° d ONLN d–X ÃdN (a à application opens the QuickT ‰` ° d ONLN dÏXMd™ )Åake 100 device driver ‡ ° d ONLN dX´d∞ )^. . ° d ONLN dh ät ¥ (q ätimerOn ° d ONLN d h Ãt ÷ )BIf ° d ONLN dh ÷t Ó )
TRUE ° d ONLN dh Ótx ) , the camera will take a pictur R` ° d ONLN d2hxt )ä$e at the expiration of its internal ° d ONLN dVt ÃÄ Â (} Ãtimer ¬† ° d ONLN d[t ‰Ä Û ). If ¬† ° d ONLN d`t ÛÄ )FALSE ¬† ° d ONLN detÄC ) , the pictur ï ° d ONLN dqtCĨ )2e is taken immediately y@ ° d ONLN dát´Ä∞ )h.
. ° d ONLN däö H£ Å (° H DESCRIPTION
. ° d ONLN dñß ä≥ û +BThe ° d ONLN döß û≥ Ï )
CmTakePicture ° d ONLN dßß Ï≥x )N function causes the camera curr R` ° d ONLN d«ßx≥ )å ently connected to take a pictur $¿ ° d ONLN dÁß≥ )åe. ˇΔ @ ˇ ˇˇˇˇ @
Courier ° d ONLN d \ è h π )#timerOn ° d ONLN d \ π h Δ )* to ° d ONLN d \ Δ h ‰ )
FALSE ° d ONLN d \ ‰ hF ) causes the next pictur R` ° d ONLN d / \F hº )be to be taken immediately 6† ° d ONLN d H \ª h¯ )u. Setting it to ° d ONLN d X i l u Ñ ( r lTRUE ° d ONLN d \ i Ñ u( )% causes the camera to take the pictur R` ° d ONLN d Å i( uÿ )§)e at the expiration of its internal timer ï ° d ONLN d ™ i◊ u‹ )Ø.
É * ë¯ 4 Ñ * ë¯
. ° d ONLN d ≠ Ñ l å ã ( ä lIMPORT Ä ° d ONLN d ≥ Ñ ã å õ ) ANT
ˇ·ˇ‚7^
° d ONLN d ∑ è l õ ( ò lThe number of pictur fi¿ ° d ONLN d À è õ™ )^4es that can be taken by the camera must at least be . ° d ONLN d ˇ õ l ß r ( § l1 ° d ONLN d õ r ß à ) in or R` ° d ONLN d õ à ß ∫ ) der for the R` ° d ONLN d õ ∫ ß )2
CmTakePicture R` ° d ONLN d õ ß_ )N function to succeed. ˇ˛ı* ° d ONLN d5 ¨ l ∏ ∫ ( µ l
CmTakePicture ˇˇß ° d ONLN dB ¨ ∫ ∏ ‰ )N does not r Gä ° d ONLN dM ¨  ∏∞ )+.eturn to the application until the camera has . ° d ONLN d{ ∏ l ƒ r ( ¡ lfi å¿ ° d ONLN d} ∏ r ƒ )"nished attempting to take a pictur &@ ° d ONLN dü ∏ ƒ! )ñe. Car À‡ ° d ONLN d• ∏! ƒï )e should be taken to ensur æ` ° d ONLN dø ∏ï ƒú )te ° d ONLN d¡ ƒ l –% ( Õ l*that the function has completed the pictur ¨` ° d ONLN dÎ ƒ% –î )πe-taking operation when . ° d ONLN d – l ‹ ñ ( Ÿ ltimerOn ° d ONLN d
– ñ ‹ Ω )*
is specif PÄ ° d ONLN d – Ω ‹ ⁄ )'ied as PÄ ° d ONLN d – ⁄ ‹ Ú ) TRUE PÄ ° d ONLN d – Ú ‹ ˜ ). ,
Zapf Dingbats
. PÄ ° d ONLN d" ” ¸ € )
s ° d ONLN d$ ı * ˛ D ( ¸ *RESUL ëÄ ° d ONLN d) ı D ˛ h )T CODES
. ° d ONLN d1 l ô +( If a pictur R` ° d ONLN d< ô1 )-#e has successfully been taken, the R` ° d ONLN d_1 )ò
CmTakePicture R` ° d ONLN dl´ )N function r $¿ ° d ONLN dw´» ),eturns $¿ ° d ONLN d~»Ê ) noErr g` ° d ONLN dÉÂÍ ) . . ° d ONLN dÜ l! è ( l If an err Ö ° d ONLN dè è!
otocol err K` ° d ONLN dÇ›xÈÏ )*or during communication ° d ONLN döËDÙ{ (ÒD with QuickT S† ° d ONLN d•Ë{ÙÕ )7ake 100 camera. W @ ° d ONLN d∂ËÕÙ )Rindows ° d ONLN dΩÛDˇÄ (¸D
platform only _Ä ° d ONLN d ÛÄˇÇ )<.
° d ONLN dà * Q ( *SEE ALSO
. ° d ONLN d’% l1 Δ +BCmGetCameraInfo ° d ONLN d‰% Δ1 ‘ )Z on ° d ONLN dË% ‘1 Ï )page ° d ONLN dÌ% Ï1 ˇ )2-28 ° d ONLN dÒ% ˇ1 ); ° d ONLN dÛ%1p )CmTakePictureAsync ° d ONLN d%p1∫ )l, described next; ° d ONLN d%∫1‰ )JCmErase ° d ONLN d %‰1Ú )* on ° d ONLN d"2 l> Ñ (; lpage ° d ONLN d'2 Ñ> ó )2-31 ° d ONLN d+2 ó> ú ); ° d ONLN d-2 ú> )CmGetErrorInfo ° d ONLN d;2 > ˛ )T on ° d ONLN d?2 ˛> )page ° d ONLN dD2>) )2-48
n *w¯ 4o *v¯ p *p˛
ˇ·ˇ‚7^
. ° d ONLN dIa *o E (k *CmT Å ° d ONLN dLa Do ü )akePictureAsync ˇˇˇˇˇˇ (kÚ2
cameraData ° d ONLN d \ à h) )BThe private data str l ° d ONLN d \) h? )]uctur >` ° d ONLN d $ \? hJ )e r ¿ ° d ONLN d ' \J h{ ) eturned by ¿ ° d ONLN d 2 \{ h√ )1 CmOpenDriver ¿ ° d ONLN d > \√ hˆ )H when your . ° d ONLN d I h à tN ( q à application opens the QuickT ‰` ° d ONLN d e hM t™ )Åake 100 device driver ‡ ° d ONLN d z h´ t∞ )^. . ° d ONLN d } x ä Ñ ¥ ( Å ätimerOn ° d ONLN d Ö x Ã Ñ ÷ )BIf ° d ONLN d à x ÷ Ñ Ó )
TRUE ° d ONLN d å x Ó Ñx ) , the camera will take a pictur R` ° d ONLN d ´ xx Ñ )ä$e at the expiration of its internal ° d ONLN d œ Ñ Ã ê  ( ç Ãtimer ¬† ° d ONLN d ‘ Ñ ‰ ê Û ). If ¬† ° d ONLN d Ÿ Ñ Û ê )FALSE ¬† ° d ONLN d fi Ñ êC ) , the pictur ï ° d ONLN d Í ÑC ê¨ )2e is taken immediately y@ ° d ONLN d Ñ´ ê∞ )h. ° d ONLN d î ä † ( ù äasyncCompletionRoutine . ° d ONLN d † à ¨ „ +B Addr C¿ ° d ONLN d † ‰ ¨0 )ess of a callback r ›¿ ° d ONLN d1 †0 ¨º )L"outine to be called after a pictur ` ° d ONLN dS †Ω ¨ )çe has been taken.
° d ONLN de ≈ H Œ Å ( à H DESCRIPTION
. ° d ONLN dq ” ä fl û +BThe ° d ONLN du ” û fl
)CmTakePictureAsync ° d ONLN dá ”
flr )l function is the asynchr R` ° d ONLN dü ”r fl∫ )honous version of R` ° d ONLN d∞ ”∫ fl )H
CmTakePicture R` ° d ONLN dΩ ” fl
)N . ° d ONLN dæ ‡ ä Ï ± ( È ä and is pr Y† ° d ONLN d« ‡ ± Ïc )')ovided for applications that pursue a dif ò‡ ° d ONLN d ‡c Ïo )≤fer {` ° d ONLN dÛ ‡o Ïå ) ent thr ±Ä ° d ONLN d˙ ‡å Ï ) ead of execution during the ° d ONLN d Ì ä ˘ ¬ ( ˆ ä
time a pictur ±† ° d ONLN d# Ì ¬ ˘[ )8#e is being taken by the camera curr J‡ ° d ONLN dF Ì\ ˘¶ )öently connected. ° d ONLN dX ˇ ä • ( äFor W j† ° d ONLN d] ˇ • ( ) indows applications, the addr ` ° d ONLN dz ˇ) ~ )Ñess of the callback r é¿ ° d ONLN dè ˇ~ )U outine handed to this function . ° d ONLN dÆ ä ‘ ( ämust be the one r R` ° d ONLN dø ‘" )Jeturned by the W ≈¿ ° d ONLN dœ !i )Mindows function ≈¿ ° d ONLN dfl i… )HMakeProcInstance ≈¿ ° d ONLN dÔ …à )`.
° d ONLN d˚2 ä> ê (; äY @Ä ° d ONLN d¸2 ê>ô )<our application should not attempt to call any of the QuickT ÊÄ ° d ONLN d82ò>ª (;òake 100 ° d ONLN d@> äJQ (G ä.driver functions including this function befor I† ° d ONLN dn>RJ{ )»
is specifi R` ° d ONLN dgisÇ )*ed as R` ° d ONLN d gÇsö )TRUE R` ° d ONLN d#gösù ). . ° d ONLN d%x äÑ î (Å äW Û` ° d ONLN d&x ìÑî ) ;indows applications cannot cancel this function by calling . ° d ONLN daÖ äë (é äCmCancelAsyncOperation ° d ONLN dwÖë )Ñ. ,
Zapf Dingbats
. ° d ONLN dyàê )s
. £ ° d ONLN dzÖ ë )
. ° d ONLN d|´ H¥ b (≤ HRESUL ëÄ ° d ONLN dÅ´ b¥ Ü )T CODES
. ° d ONLN dâπ ä≈ û +(The ° d ONLN dçπ û≈
)CmTakePictureAsync ° d ONLN düπ
≈6 )l function r R` ° d ONLN d™π6≈S ),eturns R` ° d ONLN d±πS≈q ) noErr R` ° d ONLN d∂πq≈ì ) if the r $¿ ° d ONLN døπì≈Î )"equest is successful. . ° d ONLN d÷À ä◊ ≠ (‘ ä If an err Ö ° d ONLN dflÀ ≠◊+ )# or is detected, this function r ®@ ° d ONLN d˛À+◊± )~ eturns one of the following err $` ° d ONLN d À≤◊› )á
The QuickT º@ ° d ONLN d‰Qï] )3 ake 100 driver has not been ° d ONLN d \bhì (eb
initialized.
° d ONLN dÄ Hâ o (á HSEE ALSO
. ° d ONLN dé äö +BCmAsyncCompletionRoutine ° d ONLN d/éö( )ê on ° d ONLN d3é(ö@ )page ° d ONLN d8é@öS )2-33 ° d ONLN d<éSöX ), ° d ONLN d>éXö‹ )CmCancelAsyncOperation ° d ONLN dTé‹öÍ )Ñ on ° d ONLN dXõ äß ¢ (§ äpage ° d ONLN d]õ ¢ß µ )2-34 ° d ONLN daõ µß ∫ ), ° d ONLN dcõ ∫ß )
CmTakePicture ° d ONLN dpõß )N on ° d ONLN dtõß. )page ° d ONLN dyõ.ßA )2-61 ° d ONLN d}õAßF ), ° d ONLN dõFßé ) CmEraseAsync ° d ONLN dãõéßú )H on ° d ONLN dèõúߥ )page ° d ONLN dîõ¥ß« )2-32 ° d ONLN dòõ«ßà ), ° d ONLN dö® ä¥ fi (± äCmGetErrorInfo ° d ONLN d®® fi¥ Ï )T on ° d ONLN d¨® Ï¥ )page ° d ONLN d±®¥ )2-48 ° d ONLN dµ®¥ ) ˇ ÿ @ ˇ ˇˇˇˇ @
° d ONLN d 7 ß * ≤ [ ( Ø * Constants ˇˇˇˇˇˇ a‡ ( ØÚ2 ,
Courier
. ° d ONLN d B ¬ * Œ ú ( À */* CmSetPictureMode ° d ONLN d U ¬ ú Œ )r picture modes */ ° d ONLN d g – * ‹ x ( Ÿ *
kCmColor 0x10 ° d ONLN d u fi * Í ~ *kCmColorQ 0x20 ° d ONLN d Ñ ˜ * Í * /* CmSetFlashMode flash modes */ ° d ONLN d • * Ñ *kCmFlashOn 0x02 ° d ONLN d µ * ä *kCmFlashOff 0x01 ° d ONLN d Δ! *- ê *kCmFlashAuto 0x00 ° d ONLN d ÿ: *F8 *-/* CmSetOwnerName owner name string length */ ° d ONLN dH *T ä *kCmMAXIDWIDTH 32 ° d ONLN da *m fi * /* decompression table size */ ° d ONLN d6o *{ ® *kCmDecompTableSize 98 ° d ONLN dLà *î ê */* sleep modes */ ° d ONLN d^ñ *¢ x *
kCmSleepNow 0 ° d ONLN dl§ *∞ r * kCmSleep5M 1 ° d ONLN dy≤ *æ x *
kCmSleep15M 2 ° d ONLN dá¿ *Ã x *
kCmSleep30M 3 ° d ONLN dïŒ *⁄ x *
kCmSleep60M 4 ° d ONLN d£‹ *Ë Ñ *kCmSleepNever 5 ° d ONLN d≥ı * ‰ * /* battery status indicators */ ° d ONLN d” * ~ *kPowerAdapter ° d ONLN d‚ ® ¿ )~140 ° d ONLN dÁ Ãå )$ /* Power adapter is connected */ ° d ONLN d * ñ ( *kBatteryRangeFull ° d ONLN d ® ∫ )~95 ° d ONLN d Ã Ä )$ /* Battery is fully charged */ ° d ONLN d> *+ ê (( *kBatteryIconFull ° d ONLN dP ®+ ∫ )~86 ° d ONLN dT Ã+∞ )$&/* Values >= 86 indicates the battery ° d ONLN d}- Ã9h * icon shows full charge */ ° d ONLN dò; *G ê (D *kBatteryIconHalf ° d ONLN d™; ®G ∫ )~80 ° d ONLN dÆ; ÃG¯ )$2/* Values 80 through 85 indicate that the battery ° d ONLN d„I ÃUh * icon shows half charge */ ° d ONLN d˛W *c ú (` *kBatteryRangeEmpty ° d ONLN dW ®c ∫ )~75 ° d ONLN dW Ãc‡ )$./* Battery has an insufficient charge, battery ° d ONLN dGe Ãq> * icon shows empty*/ ˇ
° d ONLN d ] H h b ( e HData òp ° d ONLN d ] b h h )T µ‡ ° d ONLN d ] h h )ypes ˇˇˇˇˇˇ a‡ ( e2 ° d ONLN d ~ H ä Ü ( á H
CameraData
. ° d ONLN d ê H ú » *For the Macintosh platform ,
Courier ° d ONLN d 2 ê » ú )Ä
CameraData ° d ONLN d < ê ú" )< is defi ° d ONLN d D ê" ú@ ) ned as ° d ONLN d L ® H ¥ ( ± H"typedef CmCameraData* CameraData; ° d ONLN d o ¿ H à v * For the W Û` ° d ONLN d x ¿ u à ¬ )-indows platform Û` ° d ONLN d à ¿ ¬ à ˛ )M
CameraData Û` ° d ONLN d í ¿ ˛ Ã )< is defi Û` ° d ONLN d ö ¿ Ã8 ) ned as ° d ONLN d ° ÿ H ‰ ( · H#typedef unsigned short CameraData;
. ° d ONLN d ≈ ˜ H Z * Buf § ° d ONLN d » ˜ Z v )ferPtr
. ° d ONLN d œ H » ( HFor the Macintosh platform ° d ONLN d Í » ˛ )Ä BufferPtr ° d ONLN d Û ˛ )6 is defi ° d ONLN d ˚ : ) ned as ° d ONLN d H, () H!typedef unsigned char* BufferPtr; ° d ONLN d%8 HD v * For the W Û` ° d ONLN d.8 uD ¬ )-indows platform Û` ° d ONLN d>8 ¬D ¯ )M BufferPtr Û` ° d ONLN dG8 ¯D )6 is defi Û` ° d ONLN dO8D2 ) ned as ° d ONLN dVP H\& (Y H%typedef unsigned char far* BufferPtr;
. ° d ONLN d|o H{ î *
CmStdFeatures
. ° d ONLN däá Hì ® *typedef struct { ° d ONLN dúï Z° Æ +short version; ° d ONLN d´£ HØ (¨ H#} CmStdFeatures, *CmStdFeaturesPtr;
. ° d ONLN dœ¬ HŒ É *
CmPortInfo
. ° d ONLN d⁄Ÿ H ® *typedef struct { ° d ONLN dÏÁ ZÛ ~ +Handle ° d ONLN d˜Á ¥Û Í )Z portIcon; ° d ONLN dı Z Æ (˛ ZStringHandle ° d ONLN dı ¥ Í )Z portName; ° d ONLN d Z Æ ( Zunsigned long ° d ONLN d3 ¥ ˆ )Z portStatus; ° d ONLN d@ Z ‰ ( ZStringHandle appName; ° d ONLN dY Z+ Í *unsigned char familyID; ° d ONLN ds- Z9 Í *unsigned char deviceID; ° d ONLN dç; ZG ¸ *unsigned short beaconParam; ° d ONLN d™I ZU Ñ *Handle ° d ONLN d∂I ¥U ˆ )Z portConfig; ° d ONLN d√W Zc ® (` Z
)B C-Language Summary of the QuickT ` )íake 100 Device Driver 4 ^ *¿¯
° d ONLN d \ * h x ( e *
CmProductInfo ,
Courier
. ° d ONLN d t * Ä ä *typedef struct { ° d ONLN d Ç < é T +char ° d ONLN d % Ç T é Z ) ° d ONLN d * Ç ñ é Í )BvendorName[8]; ° d ONLN d : ê < ú T ( ô <char ° d ONLN d C ê ñ ú2 )ZproductIdentification[16]; ° d ONLN d _ û < ™ ä ( ß <
unsigned char ° d ONLN d q û ñ ™ )ZhardwareVersion[2]; ° d ONLN d á ¨ * ∏ 0 ( µ * ° d ONLN d â ¨ < ∏ ä )
unsigned char ° d ONLN d õ ¨ ñ ∏ )ZfirmwareVersion[2]; ° d ONLN d Ø ∫ * Δ ¸ ( √ *#} CmProductInfo, *CmProductInfoPtr;
. ° d ONLN d ” Ÿ * Â p *
CmDateAndT «0 ° d ONLN d › Ÿ p Â Ç )Fime
. ° d ONLN d · * ¸ ä ( ˘ *typedef struct { ° d ONLN d Û ˛ <
ä +
unsigned char ° d ONLN d ˛ ñ
∫ )Zmonth; ° d ONLN d
< ä ( <
unsigned char ° d ONLN d ñ Æ )Zday; ° d ONLN d% <& ä (# <
unsigned char ° d ONLN d7 ñ& ¥ )Zyear; ° d ONLN d>( <4 ä (1 <
unsigned char ° d ONLN dP( ñ4 ¥ )Zhour; ° d ONLN dW6 <B ä (? <
unsigned char ° d ONLN di6 ñB ¿ )Zminute; ° d ONLN drD <P ä (M <
unsigned char ° d ONLN dÑD ñP ¿ )Zsecond; ° d ONLN dåR *^ ¸ ([ *#} CmDateAndTime, *CmDateAndTimePtr;
. ° d ONLN d∞q *} h * CmInterface
. ° d ONLN dºâ *ï ä *typedef struct { ° d ONLN dŒó <£ ä +
unsigned char ° d ONLN d·ó ®£ ˆ )l
transferRate; ° d ONLN d• <± ä (Æ <
unsigned char ° d ONLN d• ®± ¸ )lconfiguration; ° d ONLN d≥ <ø ä (º <
unsigned char ° d ONLN d&≥ ®ø ÿ )ltimeOut; ° d ONLN d/¡ *Õ ~ ( *} CmInterface;
. ° d ONLN d>‡ *Ï w * CmCameraInfo
. ° d ONLN dK˜ * ä *typedef struct { ° d ONLN d] < ä +
unsigned char ° d ONLN dp ® ¸ )lbatteryStatus; ° d ONLN dÄ < ê ( <unsigned short ° d ONLN dî ® )lnoPicturesTaken; ° d ONLN d¶! <- ê (* <unsigned short ° d ONLN d∫! ®-8 )lnoPictureImageAvailable; ° d ONLN d‘/ <; ê (8 <unsigned short ° d ONLN dË/ ®; )lfullImageWidth; ° d ONLN d˘= <I ê (F <unsigned short ° d ONLN d
= ®I )lfullImageHeight; ° d ONLN d K <W ê (T <unsigned short ° d ONLN d3K ®W )lthumbnailImageWidth; ° d ONLN dIY <e ê (b <unsigned short ° d ONLN d]Y ®e& )lthumbnailImageHeight; ° d ONLN dtg <s ä (p <
CmDateAndTime ° d ONLN dág ®s )lcameraDateAndTime; ° d ONLN dõu <Å ä (~ <
unsigned char ° d ONLN dÆu ®Å ‰ )l
flashMode; ° d ONLN d∫É <è ê (å <unsigned short ° d ONLN dŒÉ ®è ˆ )l
exposureTime; ° d ONLN d›ë <ù ê (ö <unsigned short ° d ONLN dÒë ®ù ÿ )lFNumber; ° d ONLN d˚ü <´ ä (® <
unsigned char ° d ONLN dü ®´ )l pictureMode; ° d ONLN d ≠ <π ä (∂ <
unsigned char ° d ONLN d \ Δ hD )lfullImageDatCompMode; ° d ONLN d * j Z v ® ( s Z
unsigned char ° d ONLN d = j Δ vJ )lthumbImageDatCompMode; ° d ONLN d U x Z Ñ ® ( Å Z
unsigned long ° d ONLN d h x Δ Ñ& )ltotalMemorySize; ° d ONLN d z Ü Z í ® ( è Z
unsigned long ° d ONLN d ç Ü Δ í )lfreeMemorySize; ° d ONLN d û î Z † r ( ù Zchar ° d ONLN d ® î Δ † )lownerName[32]; ° d ONLN d ∏ ¢ Z Æ ® ( ´ Z
unsigned char ° d ONLN d À ¢ Δ Æ )lCCDSensorType; ° d ONLN d € ∞ Z º ú ( π Z CmInterface ° d ONLN d Ï ∞ Δ º )lhostInterface; ° d ONLN d ˝ æ Z ® ( « Z
unsigned char ° d ONLN d æ Δ b )lcameraInformationBytes[6]; ° d ONLN d, Ã Z ÿ ® ( ’ Z
unsigned char ° d ONLN d? Ã Δ ÿb )lcompDecompParamVersion[4]; ° d ONLN d[ ⁄ Z Ê ® ( „ Z
unsigned char ° d ONLN dn ⁄ Δ ÊJ )lcolorMatrixVersion[4]; ° d ONLN dÜ Ë Z Ù ® ( Ò Z
unsigned char ° d ONLN dô Ë Δ ÙJ )lspareImageMemoryBlock; ° d ONLN d± ˆ Z Æ ( ˇ Zunsigned short ° d ONLN d≈ ˆ Δ> )lnoBasePicturesTaken; ° d ONLN d€ Z Æ (
Zunsigned short ° d ONLN dÔ ΔP )lnoQuarterPicturesTaken; ° d ONLN d Z ® ( Z
unsigned char ° d ONLN d Δ )l sleepDelay; ° d ONLN d' H,J () H+} CmCameraInfo, FarPointer CmCameraInfoPtr;
. ° d ONLN dS? HK í *
CmPictureInfo
. ° d ONLN daV Hb Æ *typedef struct { ° d ONLN dtd Zp Æ +unsigned short ° d ONLN dàd Δp )l
pictureNo; ° d ONLN dîr Z~ ® ({ Z
unsigned long ° d ONLN dßr Δ~ )limageDataSize; ° d ONLN d∑Ä Zå Æ (â Zunsigned short ° d ONLN dÀÄ Δå Í )lwidth; ° d ONLN d”é Zö Æ (ó Zunsigned short ° d ONLN dÁé Δö )lheight; ° d ONLN dú Z® ® (• Z
CmDateAndTime ° d ONLN dú Δ® )l dateAndTime; ° d ONLN d™ Z∂ ® (≥ Z
unsigned char ° d ONLN d$™ Δ∂ )l
flashMode; ° d ONLN d0∏ Zƒ Æ (¡ Zunsigned short ° d ONLN dD∏ Δƒ )l
exposureTime; ° d ONLN dSΔ Z“ Æ (œ Zunsigned short ° d ONLN dgΔ Δ“ ˆ )lFNumber; ° d ONLN dq‘ Z‡ ® (› Z
unsigned char ° d ONLN dÑ‘ Δ‡ )l pictureMode; ° d ONLN dí‚ ZÓ ® (Î Z
unsigned char ° d ONLN d•‚ ΔÓ> )ldataCompressionMode; ° d ONLN dª Z¸ ® (˘ Z
unsigned char ° d ONLN dŒ Δ¸ )ldefectiveFlag; ° d ONLN d›˛ H
( H#} CmPictureInfo, *CmPictureInfoPtr;
. ° d ONLN d H) ó *
CmColorMatrix
. ° d ONLN d5 HA ® *typedef struct { ° d ONLN d!C ZO2 +$unsigned char colorMatrixVersion[4]; ° d ONLN dGQ Z] *!double colorCorrectionMatrix[12]; ° d ONLN di_ Hk (h H$} CmColorMatrix, *CmColorMatrixPtr; ˇ \ @ ˇ ˇˇˇˇ @
)B C-Language Summary of the QuickT ` )íake 100 Device Driver 4 ^ *¿¯
h * n¯ 4 i * m¯ j * j¯
ˇ·ˇ‚7^
° d ONLN d ] * h \ ( e *
Functions ˇˇˇˇˇˇ a‡ ( eÚ2 ° d ONLN d ~ * ä “ ( á * Opening and Closing the QuickT K@ ° d ONLN d * ~ — ä? )ßake 100 Device Driver ,
Courier
. ° d ONLN d @ ñ * ¢ ¿ ( ü *pascal OSErr CmOpenDriver ° d ONLN d a § ® ∞J +~(CameraDataPtr cameraData); ° d ONLN d } Ω * … Δ ( Δ *pascal OSErr CmCloseDriver ° d ONLN d ü À ® ◊8 +~(CameraData cameraData);
. ° d ONLN d ∏ Í * ˆ q ( Û * Connecting W „– ° d ONLN d ƒ Í q ˆ ∫ )Gith the Camera
. ° d ONLN d ” *
Δ (
*pascal OSErr CmGetPortInfo ° d ONLN d ı ®2 +~(CameraData cameraData, ° d ONLN d ®)& * unsigned long index, ° d ONLN d1+ ®7Ü *% CmPortInfoHandlePtr portInfoHandle); ° d ONLN dWD *P fi (M * pascal OSErr CmDisposePortInfo ° d ONLN d}R ®^8 +~(CameraData cameraData, ° d ONLN dù` ®lt *" CmPortInfoHandle portInfoHandle); ° d ONLN d¿y *Ö Æ (Ç *pascal OSErr CmConnect ° d ONLN dfiá ®ì8 +~(CameraData cameraData, ° d ONLN d˛ï ®°t *" CmPortInfoHandle portInfoHandle); ° d ONLN d!Æ *∫ ¿ (∑ *pascal OSErr CmDisconnect ° d ONLN dBº ®»8 +~(CameraData cameraData);
. ° d ONLN d[€ *Á † (‰ *Controlling the Camera
. ° d ONLN drÛ *ˇ “ * pascal OSErr CmGetCameraInfo ° d ONLN dñ ®
8 +~(CameraData cameraData, ° d ONLN d∂ ®V * CmCameraInfoPtr cameraInfo); ° d ONLN d‘( *4 ÿ (1 * pascal OSErr CmGetPictureInfo ° d ONLN d˘6 ®B8 +~(CameraData cameraData, ° d ONLN dD ®PD * unsigned short pictureNo, ° d ONLN d;R ®^b * CmPictureInfoPtr pictureInfo); ° d ONLN d[k *w ¢ (t *pascal OSErr CmErase ° d ONLN dwy ®Ö8 +~(CameraData cameraData); ° d ONLN dêí *û ¿ (õ *pascal OSErr CmEraseAsync ° d ONLN d±† ®¨8 +~(CameraData cameraData, ° d ONLN d—Æ ®∫Ê *5 CmAsyncCompletionRoutinePtr asyncCompletionRoutine); ˇ‹ @ ˇ ˇˇˇˇ @
Courier . ° d ONLN d \ H h ( e H#typedef void (CallbackProc)(void); ° d ONLN d $ j H vt *2typedef CallbackProc* CmAsyncCompletionRoutinePtr; ° d ONLN d W É H è *#pascal OSErr CmCancelAsyncOperation ° d ONLN d É ë ÿ ùh +ê(CameraData cameraData); ° d ONLN d ú ™ H ∂ ˆ ( ≥ H pascal OSErr CmGetStdFeatures ° d ONLN d ¡ ∏ Δ ƒV +~(CameraData cameraData, ° d ONLN d · Δ Δ “í *" CmStdFeaturesPtr stdFeaturesPtr, ° d ONLN d ‘ Δ ‡ * short length); ° d ONLN d Ì H ˘ ˆ ( ˆ H pascal OSErr CmGetProductInfo ° d ONLN d@ ˚ ΔV +~(CameraData cameraData, ° d ONLN d` ΔÄ * CmProductInfoPtr productInfo); ° d ONLN dÄ" H.å (+ H6pascal OSErr CmRestoreDefaults(CameraData cameraData); ° d ONLN d∑; HG ˆ * pascal OSErr CmSetDateAndTime ° d ONLN d‹I ΔUV +~(CameraData cameraData, ° d ONLN d¸W ΔcÄ * CmDateAndTimePtr dateAndTime); ° d ONLN d p H| Í (y Hpascal OSErr CmSetOwnerName ° d ONLN d?~ ΔäV +~(CameraData cameraData, ° d ONLN d_å ΔòP * BufferPtr* ownerName); ° d ONLN dw• H± ˆ (Æ H pascal OSErr CmSetPictureMode ° d ONLN dú≥ ΔøV +~(CameraData cameraData, ° d ONLN dº¡ ΔÕn * unsigned char pictureMode); ° d ONLN dŸ⁄ HÊz („ H3pascal OSErr CmSetFlashMode(CameraData cameraData, ° d ONLN dË ΔÙ8 +~Boolean flashMode); ° d ONLN d( H
ÿ (
Hpascal OSErr CmSetSleep ° d ONLN dH ΔV +~(CameraData cameraData, ° d ONLN dh Δ)8 * short sleepDelay); ° d ONLN d|6 HB ¸ (? H pascal OSErr CmGetDecompTable ° d ONLN d¢D ΔPV +~(CameraData cameraData, ° d ONLN d¬R Δ^h * BufferPtr decompTablePtr); ° d ONLN dfik Hw ñ (t H
pascal OSErr ° d ONLN dÎk ñw2 )NCmGetColorCorrectionMatrix ° d ONLN dk2w8 )ú ° d ONLN dy ΔÖV (Ç Δ(CameraData cameraData, ° d ONLN d.á ΔìÄ * CmColorMatrixPtr colorMatrix); ˇ ™ @ ˇ ˇˇˇˇ @
)B C-Language Summary of the QuickT ` )íake 100 Device Driver 4 ^ *¿¯ ,
Courier
. ° d ONLN d \ * h à ( e *pascal OSErr CmGetErrorInfo ° d ONLN d # j ® v8 +~(CameraData cameraData, ° d ONLN d C x ® Ñ * shortPtr category, ° d ONLN d ^ Ü ® í * shortPtr detail); ° d ONLN d q ü * ´ à ( ® *pascal OSErr CmCheckIfReady ° d ONLN d î ≠ ® π8 +~(CameraData cameraData); ° d ONLN d ≠ Δ * “ ¥ ( œ *pascal OSErr CmSelfTest ° d ONLN d à ‘ ® ‡8 +~(CameraData cameraData);
. ° d ONLN d Â Û * ˇ — ( ¸ * Retrieving and Capturing Images
. ° d ONLN d
* Í * pascal OSErr CmGetThumbnailImage ° d ONLN d- ®$8 +~(CameraData cameraData, ° d ONLN dM& ®2D *unsigned short pictureNo, ° d ONLN do4 ®@D *BufferPtr thumbnailBuffer, ° d ONLN dëB ®Nt *"unsigned long numberOfBytesToRead, ° d ONLN dªP ®\ *Boolean firstRead, ° d ONLN d’^ ®j& *LongPtr actualBytes); ° d ONLN dÎw *Éí (Ä *<pascal OSErr CmGetThumbnailImageAsync(CameraData cameraData, ° d ONLN d/Ö ®ë> +~unsigned short pictureNo, ° d ONLN dPì ®üD *BufferPtr thumbnailBuffer, ° d ONLN dr° ®≠t *"unsigned long numberOfBytesToRead, ° d ONLN dúØ ®ª *Boolean firstRead, ° d ONLN d∂Ω ®…‡ *4CmAsyncCompletionRoutinePtr asyncCompletionRoutine); ° d ONLN dÎ÷ *‚n (fl *6pascal OSErr CmGetFullSizeImage(CameraData cameraData, ° d ONLN d)‰ ®> +~unsigned short pictureNo, ° d ONLN dJÚ ®˛, *BufferPtr imageBuffer, ° d ONLN dh ® t *"unsigned long numberOfBytesToRead, ° d ONLN dí ® *Boolean firstRead, ° d ONLN d¨ ®(& *LongPtr actualBytes); ° d ONLN d¬5 *Aå (> *;pascal OSErr CmGetFullSizeImageAsync(CameraData cameraData, ° d ONLN dC ®O> +~unsigned short pictureNo, ° d ONLN d&Q ®], *BufferPtr imageBuffer, ° d ONLN dD_ ®kt *"unsigned long numberOfBytesToRead, ° d ONLN dnm ®y *Boolean firstRead, ° d ONLN dà{ ®á‡ *4CmAsyncCompletionRoutinePtr asyncCompletionRoutine); ° d ONLN dΩî *†V (ù *2pascal OSErr CmTakePicture(CameraData cameraData, ° d ONLN d˜¢ ®Æ +~Boolean timerOn); ˇ† @ ˇ ˇˇˇˇ @
Courier . ° d ONLN d \ H hí ( e H7pascal OSErr CmTakePictureAsync(CameraData cameraData, ° d ONLN d ? j Δ v, +~Boolean timerOn, ° d ONLN d X x Δ Ñ˛ *4CmAsyncCompletionRoutinePtr asyncCompletionRoutine);
An asynchr <¿ ° d ONLN d ºS »≥ )3onous operation is alr 5Ä ° d ONLN d ‡ º≥ »‡ )`
eady in pr *‡ ° d ONLN d Í º‡ »Ó )-ogr ÙÄ ° d ONLN d Ì ºÓ » )ess. ° d ONLN d Ú » ‘* ( — W Û` ° d ONLN d Û ») ‘â ) indows platform only 1‡ ° d ONLN d »â ‘é )`. . ° d ONLN d
‘ H ‡ ∫ ( › HkCmAlreadyOpenError . , ° d ONLN d ‘ ˜ ‡ )Ø-6202 ° d ONLN d$ ‘ ‡[ ))
The CM is alr ¿ ° d ONLN d1 ‘\ ‡å )<
eady open. . ° d ONLN d< ‡ H Ï ê ( È H kCmANIPError . , ° d ONLN dI ‡ ˜ Ï )Ø-6203 ° d ONLN dO ‡ ÏS ))
No asynchr hÄ ° d ONLN dY ‡S Ï· )3 onous operation is outstanding. . ° d ONLN dz Ï H ¯ ú ( ı HkCmBadArgError . , ° d ONLN dâ Ï ˜ ¯ )Ø-6204 ° d ONLN dè Ï ¯Ø )) Parameter is or contains an addr ‰ ° d ONLN dØ ÏØ ¯ )èess of an invalid data ° d ONLN dΔ ¯ 8 ( item. . ° d ONLN dÕ H ú (
HkCmCameraError . , ° d ONLN d‹ ˜ )Ø-6200 . ° d ONLN d‚ . ))Err R` ° d ONLN dÂ.æ ) or detected by the camera. Call R` ° d ONLN dæ )êCmGetErrorInfo R` ° d ONLN d )T. ° d ONLN d H à ( HkCmCameraNotFoundError . , ° d ONLN d, ˜ )Ø-6206 ° d ONLN d2 ‰ )),Device connected to the port is not a QuickT ™Ä ° d ONLN d^„ )√ake 100 ° d ONLN df (B (% camera. . ° d ONLN dn( H4 ñ (1 H
kCmCantCancel . ° d ONLN d}( 45 )ÿCurr U¿ ° d ONLN dÅ(54® )ently outstanding asynchr √ ° d ONLN dö(®4 )sonous operation cannot ° d ONLN d±4 @X (=
be canceled. . ° d ONLN dø@ HL ‰ (I HkCmCurrentlyConnectedError . , ° d ONLN d⁄@ ˜L )Ø-6205 ° d ONLN d‡@ Lk ))The camera is alr è ° d ONLN dÒ@kL≤ )Keady connected. . ° d ONLN dL HX ê (U H kCmCommError . , ° d ONLN dL ˜X )Ø-6214 ° d ONLN dL X' ))A ∫† ° d ONLN dL'Xò ) serial communication err ∂` ° d ONLN d.LòX¿ )q or occurr ≥@ ° d ONLN d7L¿XÕ )(ed. . ° d ONLN d;X Hd “ (a HkCmDriverNotLoadedError . , ° d ONLN dSX ˜d )Ø-6213 ° d ONLN dYX dÊ ))-The camera device driver was not initialized. . ° d ONLN dád Hp ® (m HkCmNoMemoryError . , ° d ONLN dòd ˜p )Ø-6209 ° d ONLN dûd p≤ )) System failed to allocate memory =` ° d ONLN dæd≤p¥ )í. . ° d ONLN d¿p H| ¿ (y HkCmNotConnectedError . , ° d ONLN d’p ˜| )Ø-6208 ° d ONLN d€p |' ))A ∫† ° d ONLN d‹p'|˝ )/ connection with the camera has not been made. . ° d ONLN d | Hà ¥ (Ö HkCmNoSuchPortError . , ° d ONLN d | ˜à )Ø-6210 ° d ONLN d%| à4 ))Corr ƒ ° d ONLN d)|4àπ ) esponding port does not exist. . ° d ONLN dHà Hî ¢ (ë HkCmNotOpenError . ∏¿ ° d ONLN dXà ˜î )Ø-621 ° d ONLN d\à î )1 ° d ONLN d^à îØ ) The CM has not been initialized. . ° d ONLN dî H† ® (ù HkCmProtocolError . , ° d ONLN dêî ˜† )Ø-6212 ° d ONLN dñî †) ))Pr N† ° d ONLN dòî*†T )
eate a window ò‡ ° d ONLN d,∏hƒm )@. . ° d ONLN d/ƒ H– Ñ (Õ H
kNoPortErr . , ° d ONLN d:ƒ ˜– )Ø-7947 ° d ONLN d@ƒ –4 ))Corr ƒ ° d ONLN dDƒ4–ª ) esponding port does not exist. . ° d ONLN dd– H‹ ~ (Ÿ H kNoPodErr . , ° d ONLN dn– ˜‹ )Ø-7937 ° d ONLN dt– ‹‰ )),Device connected to the port is not a QuickT ™Ä ° d ONLN d†–„‹ )√ake 100 ° d ONLN d®‹ ËB ( camera. . ° d ONLN d∞Ë HÙ ∫ (Ò HkSoftwareInstallErr . , ° d ONLN dƒË ˜Ù )Ø-7945 ° d ONLN d Ë Ù∑ ))"Either or both the GeoPort or Shar } ° d ONLN dÏË∑ÙÁ )ó ed Library ° d ONLN d˜Ù É (˝ Manager extensions ar O‡ ° d ONLN d ÙÑ ¯ )de not installed. Macintosh ° d ONLN d' \ (
platform only _Ä ° d ONLN d4 \ a )<. . ° d ONLN d7 H Ñ ( H
memFullErr . , ° d ONLN dB ¸ )¥-108 ° d ONLN dG î )$Not enough memory to pr Ê¿ ° d ONLN d^ î¡ )t ocess the r ≤Ä ° d ONLN di ¬Ï ). equested ° d ONLN dr $Ω (! "operation. Macintosh platform only ÍÄ ° d ONLN dîº$¡ )ú. . ° d ONLN dó$ H0 x (- HparamErr . , ° d ONLN d†$0 )π-50 ° d ONLN d§$ 0Ø ) Parameter is or contains an addr ‰ ° d ONLN dƒ$Ø0 )èess of an invalid data ° d ONLN d€0 <¶ (9 item. Macintosh platform only
° d ONLN d \ l hF ( e l1The information in this chapter applies to QuickT @` ° d ONLN d 1 \F hÌ )⁄$ake 100 images on the Macintosh and ° d ONLN d U i l u v ( r lW Û` ° d ONLN d V i u u » ) indows platforms. ° d ONLN d i { l á Ø ( Ñ lThis chapter pr ° ° d ONLN d x { Ø á^ )C(ovides a brief description of the QuickT –@ ° d ONLN d † {] áÜ )Æ ake 100 fi 5¿ ° d ONLN d ™ {á áÎ )*le format, information ° d ONLN d ¡ à l î √ ( ë labout the memory r Q‡ ° d ONLN d ” à ƒ î € )Xequir i ° d ONLN d ÿ à € î˜ )>ements for the display formats supported by the Macintosh and ° d ONLN d ï l ° v ( û lW Û` ° d ONLN d ï u ° ø ) indows image pr Ɔ ° d ONLN d& ï ¿ ° )Kocessing softwar † ° d ONLN d6 ï
°· )J1e, and information about the color depth of each ° d ONLN dg ¢ l Æ| ( ´ l;display format. For information about how to display QuickT ó` ° d ONLN d¢ ¢{ ÆÀ ( ´{ake 100 images in ° d ONLN d¥ Ø l ª v ( ∏ lW Û` ° d ONLN dµ Ø u ª „ ) indows applications, see ñÄ ° d ONLN dŒ Ø ‰ ªm )o Chapter 4, “Displaying QuickT %@ ° d ONLN dÎ Øm ªœ )âake 100 Images in a W Û` ° d ONLN d ØŒ ªÒ )aindows ° d ONLN d º l » ß ( ≈ l
Application.” ° d ONLN d∑ Ë l Ù å *QuickT ÄÄ ° d ONLN dΩ Ë å Ù ⁄ ) ake 100 images ar p` ° d ONLN dŒ Ë ⁄ Ù Ú )Ne stor s‡ ° d ONLN d‘ Ë Ú Ùl )ed in the camera in a compr +Ä ° d ONLN dÔ Ëm Ù™ ){essed format. y@ ° d ONLN d˝ Ë™ Ù∞ )=Y 9¿ ° d ONLN d˛ Ë∞ Ù¡ )ou r ˚` ° d ONLN d Ë¡ ÙÒ ) etrieve the ° d ONLN d ı l à ( ˛ lcompr ‡ ° d ONLN d ı â fi ) essed image data fr 6 ° d ONLN d& ı fiÕ )U4om the camera by making function calls to the QuickT ¬ ° d ONLN dZ ıÃÔ )Óake 100 ° d ONLN db l ¶ ( l
device driver I¿ ° d ONLN do ¶ fl ): . The QuickT Ü ° d ONLN d{ fiô )8)ake 100 device driver loads the raw compr ƒ` ° d ONLN d§ôÁ )ªessed image data ° d ONLN dµ l s ( lfr ò‡ ° d ONLN d∑ s ) om the camera into host memory ≈@ ° d ONLN d’3 )ë
. On the W √@ ° d ONLN dfl3∫ )/ indows platform, the image pr ò¿ ° d ONLN d¸∫· )á ocessing ° d ONLN d l( ç (% lsoftwar ‰¿ ° d ONLN d ç( û )!e pr ıÄ ° d ONLN d û(- ) ovides function calls to decompr Δ` ° d ONLN d0 .(„ )ê(ess the raw image data in memory into a ° d ONLN dX) l5K (2 l1format that can be displayed on the host computer @ ° d ONLN dâ)J5” )fi . On the Macintosh platform, a ° d ONLN d®6 lB å (? lQuickT fi‡ ° d ONLN dÆ6 åB Δ ) ime decompr K ° d ONLN dπ6 «B Í );essor pr > ° d ONLN d¡6 ÍBn )# ovides the necessary image pr Ó¿ ° d ONLN dfi6nBΩ )Ñocessing services. ° d ONLN dÚH lT (Q l%On the Macintosh platform, the QuickT
‡ ° d ONLN dHTC )Æ ake 100 fi p` ° d ONLN d!HCT¨ ))les saved by the QuickT † ° d ONLN d8H¨Tœ )iake 100 ° d ONLN d@U lao (^ l;application contain a 512 byte header of application-specifi B ° d ONLN d|Upa— (^pc data followed by an ° d ONLN díb ln (k lin-memory Macintosh PICT fi à† ° d ONLN d≠b n6 )Ñle and a QuickT ®@ ° d ONLN dºb5nô )Eake 100 thumbnail defi ã¿ ° d ONLN d“bön⁄ )enition. QuickT ∑† ° d ONLN d‡bŸnÍ )?ake ° d ONLN d‰o l{ É (x l100 fi ¿ ° d ONLN dÍo Ñ{∫ )Hles can be displayed on the Macintosh by taking all of the data in the fi „ ° d ONLN d3o∫{Î (x∫
le after the ° d ONLN d@| là r (Ö lfi å¿ ° d ONLN dB| ràÎ )Srst 512 bytes and displaying that data with QuickDraw in the same way that a PICT fi LJ ° d ONLN dñ|Ïàˆ (ÖÏle ° d ONLN dôâ lï ´ (í l
with a QuickT 2 ° d ONLN d¶â ´ï ⁄ )? ime compr ∏‡ ° d ONLN dØâ ⁄ïQ )/essed opcode is displayed. ° d ONLN dÀõ lß s (§ lA ∫† ° d ONLN dÃõ sßc )5 sample code listing that shows how to use the QuickT ì@ ° d ONLN dõcßÔ ) ake 100 device driver functions ° d ONLN d!® l¥ { (± lto r |‡ ° d ONLN d%® {¥ Í )etrieve raw image data fr s ° d ONLN d>® Í¥, )o
om the QuickT öÄ ° d ONLN dK®+¥Ñ )Aake 100 camera is pr ‡@ ° d ONLN d_®Ñ¥≥ )Y
ovided on ,` ° d ONLN di®¥¥À )0page @ ° d ONLN dn®Ã¥Ÿ )2-5 [ ° d ONLN dq®Ÿ¥Ê )
in ° d ONLN duµ l¡ ¬ (æ lChapter 2, “QuickT Ȇ ° d ONLN dáµ ¡¡& )Uake 100 Driver Softwar $† ° d ONLN dùµ'¡3 )fe.” n@ ° d ONLN d†µ3¡5 )
lQuickT ÄÄ ° d ONLN dƒ å ⁄ ) ake 100 images ar p` ° d ONLN d’ ⁄ Ú )Ne stor s‡ ° d ONLN d€ Ú ) ed in thr ο ° d ONLN d‰D )%
ee image r Y ° d ONLN dÓEí ).esolutions: high-r ¶Ä ° d ONLN d íø )M esolution, ° d ONLN d l ç ( lstandar ±Ä ° d ONLN d ç ö )!d-r Ê ° d ONLN d ö w )
.esolution, and thumbnail. The amount of memory ˇ¿ ° d ONLN dCv æ )‹, in bytes, for thr Æ ° d ONLN dVø Ë )I ee image ° d ONLN d_ l* o (' lr E ° d ONLN d` p*o )8esolutions in the output formats supported by the QuickT ›@ ° d ONLN dò n*∏ )˛ake 100 image pr í@ ° d ONLN d® π*‡ )K ocessing ° d ONLN d±+ l7 ç (4 lsoftwar ‰¿ ° d ONLN d∏+ ç7 … )!e is shown in 9¿ ° d ONLN dΔ+ 7 – )=T oÄ ° d ONLN d«+ œ7 Ò )able 3-1 } ° d ONLN dœ+ Ò7 ˆ )". ˇ2 @ ˇ ˇˇˇˇ @
\ » gS )> Memory sizes of supported QuickT É0 ° d ONLN d * \R gœ )ä ake 100 image formats in bytes ° d ONLN d K t ä ¬ ( | ä Image format ° d ONLN d X t ¸ > )rHigh-resolution ° d ONLN d h tJ ü )NStandard-resolution ° d ONLN d | t§ — )Z Thumbnail ° d ONLN d à ~ ¸ âF ( Ü ¸(640 x 480 pixels) ° d ONLN d õ ~J âî )N(320 x 240 pixels) ° d ONLN d Æ ~§ ≠)Z(80 x 60 pixels)
° d ONLN d ¿ å ã ò – ( ï ã ADPCM compr õ@ ° d ONLN d À å – ò Ë )Eessed å† ° d ONLN d — å ò )<1 ° d ONLN d “ å ò, )15,200 ° d ONLN d Ÿ å_ òz )N28,800 ü` ° d ONLN d ‡ å∑ ò« )Xn/a ° d ONLN d  û ã ™ ≤ ( ß ã Color dif ` ° d ONLN d Ó û ≥ ™ ø )(fer ȇ ° d ONLN d Ò û æ ™ — ) ence ° d ONLN d ˆ û ™, )N307,200 ° d ONLN d ˛ û_ ™z )S76,800 ° d ONLN d û¥ ™» )U4800 ° d ONLN d ∞ ã º € ( π ãThumbnail compr w‡ ° d ONLN d ∞ € º Û )Pessed ü` ° d ONLN d ∞ º+ )@n/a ü` ° d ONLN d$ ∞i ºy )Nn/a ° d ONLN d( ∞¥ º» )K2400 ° d ONLN d. ¬ ã Œ ( À ã8-bit grayscale ° d ONLN d> ¬ Œ, )Å307,200 ° d ONLN dF ¬_ Œz )S76,800 ü` ° d ONLN dM ¬∑ Œ« )Xn/a ° d ONLN dR ‘ ã ‡ ∑ ( › ã
24-bit DIB ° d ONLN d] ‘ ‡, )Å921,600 ° d ONLN de ‘Z ‡z )N230,400 ü` ° d ONLN dm ‘∑ ‡« )]n/a ° d ONLN dr Ê ã Ú ∫ ( Ô ã
32-bit RGB ° d ONLN d} Ê Ú, )y 1,228,800 ° d ONLN dá ÊZ Úz )V307,200 ü` ° d ONLN dè Ê∑ Ú« )]n/a ° d ONLN dì ¯ ä∫ ( äCDIB (device-independent bitmap) is the native image format for Micr D ° d ONLN d÷ ¯ª› (ªosoft W ı† ° d ONLN d› ¯‹ )!indows. ° d ONLN dÂ ä• ( äCThis array of RGB triples contains only the image data. It is the r ∂Ä ° d ONLN d(•˚ (•esponsibility of the ° d ONLN d= ä î ( äW Û` ° d ONLN d> ì Ù ) indows application pr P` ° d ONLN dS ı õ )b$ogrammer to imbed the data in the pr ¶‡ ° d ONLN dwõ ˆ )¶oper bitmap format.
The QuickT º@ ° d ONLN d™a Ωm )3ake 100 image pr q@ ° d ONLN d∫amQ )Kocessing softwar »@ ° d ONLN d aQm° )Ie converts QuickT +` ° d ONLN d€a°m˙ )Pake 100 images into ° d ONLN dÔn äz ≤ (w ä display-r S† ° d ONLN d¯n ≤z ‰ )( eady pictur ±` ° d ONLN dn ‰z“ )25es with the color depth and display formats shown in 7@ ° d ONLN d8n”zŸ )ÔT m ° d ONLN d9nÿz˙ )able 3-2 zÄ ° d ONLN dAn˙zˇ )".
û H¶ 4ü H¶ ¢ ä¢
ˇ·ˇ‚7^
° d ONLN dDî äü ± (ú ä Table 3-2 ° d ONLN dNî »üx )>-Picture display formats and color resolutions ° d ONLN d~¨ ä∑ » (¥ äDisplay format ° d ONLN dç¨ fi∑ )TBits per pixel ° d ONLN dú¨,∑H )NColors ° d ONLN d£¨n∑fi )BOperating-system support
° d ONLN dΩ∫ äΔ µ (√ ä Grayscale ° d ONLN d«∫ fiΔ „ )T8 ° d ONLN d…∫,Δ; )N256 ° d ONLN dÕ∫nΔº )BMacintosh, MS W ç‡ ° d ONLN d‹∫ºΔ‹ )Nindows ° d ONLN d‰Ã äÿ ù (’ äDIB ° d ONLN dÈà fiÿ Ë )T24 ° d ONLN dÏÃ,ÿ_ )N 16.7 million ° d ONLN d˘Ãnÿx )BW Û` ° d ONLN d˙Ãwÿó ) indows ° d ONLN dfi äÍ û (Á äRGB ° d ONLN dfi fiÍ Î )T32* ° d ONLN d
fi,Í_ )N 16.7 million ° d ONLN dfinÍú )B Macintosh ° d ONLN d! ä¸ “ (˘ ä* The 32-bits-per G@ ° d ONLN d2 ”¸/ )I-pixel RGB format pr ‰† ° d ONLN dF/¸¬ )\#ovides only 24 bits of color using ° d ONLN di¸ ä ı ( äthe form NULL, Red, Gr 4Ä ° d ONLN d¸ ˆ )l
een, Blue. ˇ2 @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>3 , Helvetica
ˇˇ—Ú ˇÆ ( @ lQuickT ÎÏ )ake 100 Images 4⁄ *˙¯
(‡ *3-4
)BImage Color Depth 4 ^ *¿¯ ˇ0 @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4⁄ ∫˙ , Palatino
3, . Ã +∫#CHAPTER ÿ )h4
ˇˇu÷ ˇÆ ° d ONLN d Z ∫ wì ( p ∫Displaying QuickT ‰ˆ ° d ONLN d Zë wÏ )◊ake 100 ° d ONLN d z ∫ ó] ( ê ∫
Images in a W %Ó ° d ONLN d & z\ ó∑ )¢indows
π HX 4 π HX R HR
ˇ·ˇ‚7^ ° d ONLN d - ö ∫ ∑A ( ∞ ∫ Application ˇˇˇˇˇˇ ä* ( ∞ 4
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-2
)B Using the W ć )1
indows IPM 4 ^ *¿¯
° d ONLN d \ l h Ø ( e lThis chapter pr ° ° d ONLN d \ Ø hÑ )C/ovides an overview of the technology used to pr ° d ONLN d > \Ñ hæ )’ ocess QuickT )‡ ° d ONLN d J \æ h· ):ake 100 ° d ONLN d R i l u ( r l$images for display with the Image Pr ”@ ° d ONLN d v i uù )£ ocessing Module (IPM) in the W ¿ ° d ONLN d î iû uı )èindows application ° d ONLN d ß v l Ç É ( lenvir n† ° d ONLN d ¨ v É Çè )>onment. It also describes the data types and functions that ar á¿ ° d ONLN d Í vè dž ( èe pr òÄ ° d ONLN d Ó v† Ç› )ovided in the ° d ONLN d ¸ É l è v ( å lW Û` ° d ONLN d ˝ É u èK ) .indows IPM dynamic link library for the QuickT pÄ ° d ONLN d+ ÉK èì )÷ake 100 camera. ° d ONLN d< ï l °! ( û l(This chapter does not attempt to teach W Z¿ ° d ONLN dd ï! °N )µ indows pr ć ° d ONLN dm ïN °Ü )- ogramming. ;` ° d ONLN dx ïá °ç )9Y ˚‡ ° d ONLN dy ïå °Ì )ou should be familiar ° d ONLN dè ¢ l Æ ¥ ( ´ lwith the softwar @ ° d ONLN dü ¢ µ Æ ÿ )I e tools r ˆ† ° d ONLN d® ¢ ◊ Æ Ó )"equir
‡ ° d ONLN d≠ ¢ Ô ÆR )ed to use the IPM DLL ä ° d ONLN d¬ ¢R Æz )c in the W Ä ° d ONLN dÀ ¢z Æß )( indows pr :† ° d ONLN d‘ ¢ß Æ› )-
ogramming ° d ONLN dfi Ø l ª É ( ∏ lenvir n† ° d ONLN d„ Ø É ª ß )onment. ° d ONLN dÎ ¡ l Õ5 ( l+For information about how to display QuickT ä@ ° d ONLN d ¡5 ÕΔ )… ake 100 images in the Macintosh ° d ONLN d6 Œ l ⁄ ∑ ( ◊ lapplication envir •Ä ° d ONLN dG Œ ∑ ⁄ Ó )K onment, see Ó ° d ONLN dS Œ Ó ⁄w )7 Chapter 5, “Displaying QuickT |¿ ° d ONLN dp Œw ⁄œ )âake 100 Images in a ° d ONLN dÑ € l Á ú ( ‰ l
° d ONLN dµ* l6 ó (3 l Images ar ç@ ° d ONLN dæ* ó6 Ø )+e stor ê¿ ° d ONLN dƒ* Ø6 ¯ )ed in the QuickT ç¿ ° d ONLN d‘* ¯6m )Iake 100 camera in a compr °† ° d ONLN dÌ*m6Ë )u essed format that cannot be ° d ONLN d 7 lC o (@ lr E ° d ONLN d
7 pC? ).eadily displayed by the operating system. Ther «Ä ° d ONLN d87?CP )œefor Ä ° d ONLN d<7QCÕ ) e, it is necessary to decompr ( ° d ONLN dY7ÕC )|ess and ° d ONLN daD lP ¡ (M lconvert the QuickT π‡ ° d ONLN dsD ¿P€ )T@ake 100 images into a data format that the operating system can ° d ONLN d≥Q l] å (Z ldisplay ° d ONLN d∫Q å] Õ )
. The IPM DLL NÄ ° d ONLN d«Q Õ] Ÿ )A pr ï† ° d ONLN d Q Ÿ]R ) ovides the functions that W Æ@ ° d ONLN dÂQR] )y indows applications call to ° d ONLN d^ lj ì (g ldecompr Ê@ ° d ONLN d^ ìj ˙ )'ess and convert QuickT ÛÄ ° d ONLN d ^ ˙jC )gake 100 images r „` ° d ONLN d.^Cjq )I etrieved fr ∏Ä ° d ONLN d9^qj ). om the camera into a format ° d ONLN dUk lwr (t l:that the operating system can display on the host computer Δ‡ ° d ONLN dèkqwv (tq. ° d ONLN dí} lâ ® (Ü l The IPM DLL ØÄ ° d ONLN dù} ®â √ )< for W fi‡ ° d ONLN d£} √⥠)indows is a collection of functions that convert QuickT Ä ° d ONLN d⁄}¥â◊ )Òake 100 ° d ONLN d‚ä lñ „ (ì lcamera images to display-r fi ° d ONLN d¸ä „ñ, )weady RGB pictur &¿ ° d ONLN d ä-ñè )Je formats. The QuickT º ° d ONLN d äéñŒ )aake 100 image ° d ONLN d.ó l£ u († lpr G ° d ONLN d0ó v£ ø )
ocessing softwar û ° d ONLN d@ó ø£Ë )IBe supports display of grayscale, RGB, and DIB output formats. The ° d ONLN dǧ l∞ ∑ (≠ lIPM supports dif ∑† ° d ONLN dí§ ∑∞ √ )Kfer ö ° d ONLN dï§ √∞ñ ) +ential pulse-code modulation (DPCM) decompr á ° d ONLN d¿§ñ∞Œ )”
ession, edge ° d ONLN dÕ± lΩ Í (∫ lenhancement, and color corr i¿ ° d ONLN d˱ ÍΩi )~ ection. The default color corr è¿ ° d ONLN d±iΩfi )ection settings of a QuickT ` ° d ONLN d!±fiΩÔ )uake ° d ONLN d%æ l K (« l0100 image can be overridden with the IPM softwar ° d ONLN dUæL ™ )‡e to accommodate dif Á@ ° d ONLN diæ™ ∂ )^fer …¿ ° d ONLN dlæ∂ · )
ent video ° d ONLN dvÀ l◊S (‘ l6display characteristics. In addition, IPM functions ar ä@ ° d ONLN d¨ÀS◊d )Áe pr õ ° d ONLN d∞Àd◊∂ )ovided for image r ∂` ° d ONLN d¬À∂◊Î )R otation and ° d ONLN dŒÿ l‰; (· l.for adjusting color output using camera-specifi é@ ° d ONLN d˝ÿ;‰õ )œc color characteristics. ° d ONLN dÍ lˆ Ä (Û lTher ¿ ° d ONLN dÍ Åˆ ë )e ar ` ° d ONLN d Í ëˆö )9e two fundamental methods that can be used for the QuickT ı¿ ° d ONLN dWÍôˆŸ (Ûôake 100 image ° d ONLN de˜ l ì ( ldecompr Ê@ ° d ONLN dl˜ ì )'ession and conversion pr @ ° d ONLN dј◊ )o-ocess with the IPM: banded and unbanded. The ° d ONLN d± l Ù (
l banded method handles a user ù ° d ONLN dÕ Ù )à-specifi _ ° d ONLN d’Ù ) 1ed strip of the image, while the unbanded method ° d ONLN d l ( l$handles the complete image in memory ¿ ° d ONLN d* )Æ. Û ° d ONLN d, $ )Y ≥† ° d ONLN d-$ Ü )ou may wish to try dif Ä ° d ONLN dCá ì )cfer Í ° d ONLN dFí fi ) ent band sizes to ° d ONLN dX l* (' l optimize the image conversion pr Á‡ ° d ONLN dx *É )î ocess for various system confi µ ° d ONLN dñ Ñ*≥ )Ñ gurations. ° d ONLN d¢0 l<› (9 lSAn image band is a full-width portion of an image that can begin with any line and ° d ONLN dı= lIN *
2extend to the height of the image. Banded image pr ≠@ ° d ONLN d '=NIâ )‚ocessing is pr ° d ONLN d 5=äIÛ )<ovided for situations in ° d ONLN d NJ lV õ (S l
which ther Ù¿ ° d ONLN d XJ õVQ )/(e is not enough memory on the host to pr 7Ä ° d ONLN d ÄJRVÁ )∑"ocess a full image or when only a ° d ONLN d ¢W lc' (` l+full-width portion of the image is needed. 3 ° d ONLN d ÕW'c‚ )ª+An example of the latter case might be for ° d ONLN d ¯d lp o (m lr E ° d ONLN d ˘d pp9 )-edisplaying a portion of an image that was pr O@ ° d ONLN d
&d9py )…eviously cover s@ ° d ONLN d
4dyp› )@ed by another window @ ° d ONLN d
Hd›p‚ )d. ʆ ° d ONLN d
Jd·pÁ )Y ß ° d ONLN d
KdÁpÙ )ou ° d ONLN d
Nq l} — (z lcan also use banded pr ãÄ ° d ONLN d
dq —}q )e%ocessing to display bands of a pictur T¿ ° d ONLN d
âqr}£ )° e as they ar ‡ ° d ONLN d
ïq§}µ )2e pr † ° d ONLN d
ôqµ}‰ ) ocessed to ° d ONLN d
§~ lä õ (á l indicate pr @ ° d ONLN d
Ø~ úä ™ )0ogr ‡ ° d ONLN d
≤~ ™ä Ë )ess to the user f¿ ° d ONLN d
¡~ Ëä Ì )>. ˇ l @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä Using the W ć )1
indows IPM
, (‡ 4-3 4 ^ H¿
^ H k 4 ^ H k
° d ONLN d \ ä g ù ( d äNote
ˇ·ˇ‚7^
° d ONLN d
i ä u ™ *When r 1` ° d ONLN d i ´ uº )!;otating an image using either the banded or unbanded image ° d ONLN d K u ä Å ì ( ~ äpr G ° d ONLN d M u î Å+ )
#ocessing method, the full-color dif 9† ° d ONLN d p u+ Å7 )ófer ° d ONLN d s u7 Åî ) ence image must be r v‡ ° d ONLN d á uî Å¡ )] esident in ° d ONLN d í Å ä ç Ø ( ä ämemory Õ ° d ONLN d ò Å Æ ç · )$ . Banded pr Ä ° d ONLN d £ Å ‚ ç´ )4,ocessing does not apply to thumbnail images. ,
Zapf Dingbats
¥@ ° d ONLN d – Ñ∞ å∂ )Œu
@ ° d ONLN d — Å∑ çπ ) . ° d ONLN d ” í ä û ◊ ( õ äBanded image pr R` ° d ONLN d ‚ í ◊ ûc )M ocessing is performed with the ,
Courier R` ° d ONLN d íc û’ )åIpConvertADPCMtoRGB R` ° d ONLN d í’ û )r function. The ° d ONLN d# ü ä ´ ˝ ( ® äportion of the image to pr R` ° d ONLN d= ü ˝ ´= )socess is specifi R` ° d ONLN dM ü= ´u )@ ed with the R` ° d ONLN dY üu ´√ )8
aStartingLine R` ° d ONLN df ü√ ´ÿ )N and ° d ONLN dk ¨ ä ∏ ÿ ( µ ä
aLinesPerBand ° d ONLN dx ¨ ÿ ∏ fi )N f PÄ ° d ONLN dz ¨ fi ∏ )
ields in the PÄ ° d ONLN dá ¨ ∏h )6ImageAttribute PÄ ° d ONLN dï ¨h ∏é )T data str <Ä ° d ONLN dû ¨é ∏§ )&uctur ‡ ° d ONLN d£ ¨§ ∏È )e. The value of ° d ONLN d≥ π ä ≈ ÿ ( ¬ ä
aStartingLine ° d ONLN d¿ π ÿ ≈S )N must be 0 or an even number ¬† ° d ONLN d‹ πR ≈j )z, and ¬† ° d ONLN d‚ πj ≈∏ )
aLinesPerBand ¬† ° d ONLN dÔ π∏ ≈ )N must be an even . ° d ONLN d Δ ä “ ÷ ( œ änumber that is gr ¿ ° d ONLN d Δ ÷ “F )Leater than or equal to 2. T ï` ° d ONLN d, ΔF “W )po pr R ° d ONLN d0 ΔX “˛ )(ocess the full image with a single call . ° d ONLN dX ” ä fl ≈ ( ‹ ä (unbanded pr R` ° d ONLN dd ” ≈ fl );ocessing), set R` ° d ONLN ds ” flO )<
aStartingLine R` ° d ONLN dÄ ”O flv )N
to 0 and R` ° d ONLN dä ”v flƒ )'
aLinesPerBand R` ° d ONLN dó ”ƒ fl¸ )N to the total . ° d ONLN d• ‡ ä Ï ( È äimage height in pixels. . ° d ONLN dæ Ú ä ˛ û *The ° d ONLN d¬ Ú û ˛ Ú )ImageAttribute ° d ONLN d– Ú Ú ˛ )T data str l ° d ONLN dŸ Ú ˛. )&uctur >` ° d ONLN dfi Ú. ˛n )e is shown her ¿ ° d ONLN dÏ Ún ˛Ω )@e and further defi ¿ ° d ONLN d˛ ÚΩ ˛⁄ )Oned in ¿ ° d ONLN d Ú⁄ ˛ˇ ) “Data T *¿ ° d ONLN d Ú˛ ˛ )$ypes . ° d ONLN d ˇ ä ≥ ( ä for the W å¿ ° d ONLN d ˇ ≥ s ))(indows IPM Functions” beginning on page %¿ ° d ONLN dB ˇt Å )¡4-4 y† ° d ONLN dE ˇÅ Ü )
. . ° d ONLN dH ä$å (! ä+typedef struct imageAttribute { /* input */ ° d ONLN du& ú22 +unsigned short aImgWidth; ° d ONLN dê4 ú@8 *unsigned short aImgLength; ° d ONLN dµB>NÏ +¢ /* output image attributes */ ° d ONLN d‘P ú\ fi (Y ú IpPixelType ° d ONLN dÂP\J )l aPixelType; ° d ONLN dÚ^ új fi (g ú RotateAngle ° d ONLN d^j2 )laAngle; ° d ONLN d l úx (u úunsigned short ° d ONLN d lx\ )laStartingLine; ° d ONLN d0z úÜ (É úunsigned short ° d ONLN dDzÜ\ )laLinesPerBand; ° d ONLN dTà úî Ã (ë úBoolean ° d ONLN dbàîD )l
firstBand; ° d ONLN dnñ ú¢ à (ü úBoolean ° d ONLN d|ñ¢> )l lastBand; ° d ONLN dܧ ä∞ ê (≠ ä} ° d ONLN dৠú∞ ˆ )ImageAttribute; ° d ONLN dòº ä» û (≈ äThe ° d ONLN dúº û» ‘ ) firstBand ° d ONLN d•º ‘» È )6 and ° d ONLN d™º È» )lastBand ° d ONLN d≤º»" )0 fi ° d ONLN dµº"»T ) elds in the ° d ONLN d¡ºT»® )2ImageAttribute ° d ONLN dœº®»Œ )T data str l ° d ONLN dÿºŒ»‰ )&uctur >` ° d ONLN d›º‰» ) e can be . ° d ONLN dÊ… ä’è (“ ä5used to optimize performance and to manage memory mor ˝‡ ° d ONLN d…è’û (“èe ef 7` ° d ONLN d …ü’• )fi D ° d ONLN d!…•’¬ )ciently ’‡ ° d ONLN d(…¡’‚ ) . When . ° d ONLN d/÷ ä‚ ¿ (fl ä firstBand ° d ONLN d8÷ ¿‚ à )6 is ° d ONLN d<÷  ‰ ) TRUE ° d ONLN d@÷ ‰‚j ) , the IPM allocates a color dif R` ° d ONLN d_÷j‚w )Üfer $¿ ° d ONLN db÷w‚’ )
ence image (CDI) buf ˜ ° d ONLN dv÷‘‚ )]fer as needed . ° d ONLN dÑ„ äÔ ô (Ï äor r - ° d ONLN dà„ öÔ ” )
euses the buf ”‡ ° d ONLN dï„ ”Ô Ë )9fer fr |‡ ° d ONLN dõ„ ÈÔ )om a pr çÄ ° d ONLN d¢„ Ô< )" eviously pr ^ ° d ONLN d≠„=ÔÒ )2)ocessed image. In either case, it decompr ;† ° d ONLN d÷„ÒÔ )¥esses . ° d ONLN d‹ ä¸ (˘ ä the image to get the CDI. When ° d ONLN d˚ ¸S )ì firstBand ° d ONLN dS¸_ )6 is ° d ONLN d_¸} ) FALSE ° d ONLN d
}¸ ) #, it indexes into the existing CDI ° d ONLN d0˝ ä ò ( äbuf R` ° d ONLN d3˝ ò • )fer ï ° d ONLN d6˝ § ¿ ) , accor g` ° d ONLN d=˝ ¿ , ) ding to the value in the g` ° d ONLN dV˝, z )l
aStartingLine g` ° d ONLN dc˝z É )N fi g` ° d ONLN df˝É ¨ )
eld, to pr 9¿ ° d ONLN dp˝¨ ⁄ )) ocess the r ° d ONLN d{˝⁄ ). equested . ° d ONLN dÑ
ä • ( äband.
$ H2 4% H2
° d ONLN dã# ä. ù *Note
ˇ·ˇ‚7^
° d ONLN dê0 ä< ∞ *In the W † ° d ONLN dò0 ∞< Í )& indows envir N@ ° d ONLN d§0 Í<ï ):'onment it is possible to have a CDI buf ã ° d ONLN dÀ0ï<… )´
fer for each ° d ONLN dÿ< äH “ (E äapplication inter A† ° d ONLN dÈ< ”H8 )Iested in using the IPM.
ÒÄ ° d ONLN d?=GC )ju
?Ä ° d ONLN d<DHF ) . ° d ONLN dM äY ê (V äT ï ° d ONLN dM èY ≥ )able 4-1 ï ° d ONLN d
M ≥Y )$ shows how to use the ï ° d ONLN d#MYL )c firstBand ï ° d ONLN d,MLYa )6 and ï ° d ONLN d1MaYë )lastBand ï ° d ONLN d9MëYö )0 fi ï ° d ONLN d<MöYÃ ) elds in the ° d ONLN dHZ äf fi (c äImageAttribute ° d ONLN dVZ fif )T data str l ° d ONLN d_Zf )&uctur >` ° d ONLN ddZf6 )e to pr ¿ ° d ONLN dkZ6f— ) "ocess two images using the CDI buf „ ° d ONLN dçZ–f
)öfer allocated . ° d ONLN dõg äs Ø (p ä for the fi & ° d ONLN d•g ∞s ˜ )&rst image. The fi u¿ ° d ONLN d∂g ˜s6 )Grst image is pr i` ° d ONLN d≈g6sr )?ocessed in thr
† ° d ONLN d”gss )="ee bands, and the second image is ° d ONLN dıt äÄ ì (} äpr G ° d ONLN d˜t îÄ )
ocessed in the same CDI buf /` ° d ONLN dtÄX )}fer in one band. ˇ\ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-4
)B!Image Processing Module Reference 4 ^ *¿¯
g * n¯ 4 g * n¯ j l j¯
ˇ·ˇ‚7^ ° d ONLN d \ l g ì ( d l Table 4-1 ° d ONLN d
\ ™ g; )> Memory and image band processing ° d ONLN d - t m á ( | mImage ° d ONLN d 3 t ê ¶ )#Band ,
Courier . ° d ONLN d 8 t π Ô )) firstBand ° d ONLN d B t ¸ , )ClastBand . ° d ONLN d K t8 fi )<#Memory use and processing technique
° d ONLN d p Ç l é q ( ã l1 ° d ONLN d r Ç ê é ï )$1 . ° d ONLN d t Ç π é — ))TRUE ° d ONLN d y Ç ¸ é )CFALSE . ° d ONLN d Ç8 éª )< Allocate the CDI working buf f ° d ONLN d õ Ǫ é« )Éfer ∏¿ ° d ONLN d û ÇΔ éÀ ) , ° d ONLN d † ç8 ô_ ( ñ8decompr Ê@ ° d ONLN d ß ç_ ôÎ )' ess the image, and generate the ° d ONLN d « ò8 §O ( °8CDI. T` ° d ONLN d à òO §r )After pr µ@ ° d ONLN d ‘ òr §– )#ocessing, the CDI buf φ ° d ONLN d È ò– §Ë )^fer is ° d ONLN d £8 Ø; ( ¨8r E ° d ONLN d Ò £< Øa ) etained. ° d ONLN d ¸ µ l ¡ q ( æ l1 ° d ONLN d ˛ µ ê ¡ ï )$2 . ° d ONLN d µ π ¡ ◊ ))FALSE ° d ONLN d µ ¸ ¡ )CFALSE . ° d ONLN d µ8 ¡A )<Pr N† ° d ONLN d µB ¡∑ )
eviously allocated CDI buf ° d ONLN d( µ∏ ¡Û )vfer is used to ° d ONLN d7 ¿8 ÃA ( …8pr G ° d ONLN d9 ¿B î )
ocess the second band. Ω¿ ° d ONLN dP ¿® ÃÀ )fAfter pr † ° d ONLN dX ¿Ã È )$
ocessing, ° d ONLN db À8 ◊k ( ‘8 the CDI buf E ° d ONLN dm Àl ◊à )4fer is r ?† ° d ONLN du Àà ◊´ ) etained. ° d ONLN d › l È q ( Ê l1 ° d ONLN dÅ › ê È ï )$3 . ° d ONLN dÉ › π È ◊ ))FALSE ° d ONLN dâ › ¸ È )CFALSE . ° d ONLN dè ›8 ÈA )<Pr N† ° d ONLN dë ›B È∑ )
eviously allocated CDI buf ° d ONLN d´ ›∏ ÈÛ )vfer is used to ° d ONLN d∫ Ë8 ÙA ( Ò8pr G ° d ONLN dº ËB Ù{ )
ocess the thir ° d ONLN d Ë| Ù† ):d band. ¡ ° d ONLN d“ Ëü Ù¬ )#After pr " ° d ONLN d⁄ Ë√ ÙÌ )$
ocessing, ° d ONLN d‰ Û8 ˇk ( ¸8 the CDI buf E ° d ONLN dÔ Ûl ˇà )4fer is r ?† ° d ONLN d˜ Ûà ˇ´ ) etained. ° d ONLN d l q ( l2 ° d ONLN d ê ï )$1 . ° d ONLN d π — ))TRUE ° d ONLN d
¸ )CTRUE . ° d ONLN d8A )<Pr N† ° d ONLN dB∑ )
eviously allocated CDI buf ° d ONLN d+∏Û )vfer is used to ° d ONLN d:8 A (8pr G ° d ONLN d<B o )
ocess the r ‡ ° d ONLN dGp ). equested band of the second ° d ONLN dc8'X ($8image. 6¿ ° d ONLN djX'{ ) After pr ó† ° d ONLN dr{'Ÿ )#ocessing, the CDI buf œ ° d ONLN dáŸ'Ò )^fer is . ° d ONLN dé&82u (/8
deallocated ( ° d ONLN dõ&u2œ )=lastBand = True ° d ONLN d™&œ2ÿ )Z). ° d ONLN d≠&ÿ2⁄ )
U *\¯ 4V *\¯ W lW¯
ˇ·ˇ‚7^
ˇˇ‹. . ˇ◊ ° d ONLN dØF lU ‡ (Q lIPM Error Handling ˇˇˇˇˇˇ €r (Q4
° d ONLN d√\ lh ¡ (e lAll IPM functions r Ö† ° d ONLN d÷\ ¡hÈ )UEeturn a value either indicating successful completion or detailing a ° d ONLN di lu Ñ (r lfailur p¿ ° d ONLN d!i Ñu Á )e status. The include fi ᆠ° d ONLN d9i Áu )c le ipm.h defi ;† ° d ONLN dFi u— )8'nes the values and mnemonics for these ° d ONLN dmv lÇ ≠ ( lconditions. Err Ω@ ° d ONLN d|v ≠Ç√ )A@ors also appear in the “Result Codes” section for each function ° d ONLN dºÉ lè ¢ (å l
° d ONLN dÓ“ lfi (€ lTThe following sections describe the data types and functions supported by the Image ° d ONLN dBfl lÎ u *
Pr N† ° d ONLN dDfl vÎ ≈ )
ocessing Module.
˘ *¯ 4˙ *¯
° d ONLN dV¯ l ( lNote
ˇ·ˇ‚7^
° d ONLN d[ l à *This information is pr ø` ° d ONLN dq à )`ovided to give W W@ ° d ONLN dÅE )L indows pr }` ° d ONLN däE® )-ogrammers an idea of ° d ONLN dü l – ( lhow to use the QuickT ¡` ° d ONLN d¥ œ )cake 100 image pr v` ° d ONLN dƒ c )Kocessing softwar Õ` ° d ONLN d‘c û )Ie that will be ° d ONLN d„ l)  (& lavailable sometime in 1994. ,
Zapf Dingbats
‡ ° d ONLN dˇ Î( Ò )u
P‡ ° d ONLN d Ò) Û )
T *\¯ 4U *\¯ W *W˛
ˇ·ˇ‚7^
° d ONLN dD *T S (P *Data T ∏ ° d ONLN dD RT ¨ )(ypes for the W Ö ° d ONLN dD ¨T8 )Zindows IPM Functions ˇˇˇˇˇˇ (PÒ4
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä!Image Processing Module Reference
, (‡ 4-5 4 ^ H¿
j H r 4 j H r l H l
ˇ·ˇ‚7^
° d ONLN d \ H j ú ( f HImageAttribute ˇˇˇˇˇˇ ( f4
. ° d ONLN d { ä á û ( Ñ äThe ,
Courier ° d ONLN d { û á Ú )ImageAttribute ° d ONLN d " { Ú á )T str l ° d ONLN d & { á )uctur >` ° d ONLN d + { á' )e pr ¿ ° d ONLN d / {' Რ)/ovides information about the size of the QuickT %¿ ° d ONLN d ^ {˝ á )÷ake . ° d ONLN d b à ä î Ø ( ë ä100 sour ~† ° d ONLN d j à Ø î ¸ )%ce image and defi ,‡ ° d ONLN d { à ˝ î )N?nes the parameters to be used by the IPM for the image output. . ° d ONLN d ª ° ä ≠å ( ™ ä+typedef struct imageAttribute { /* input */ ° d ONLN d Ë Ø ú ª2 +unsigned short aImgWidth; ° d ONLN d Ω ú …8 *unsigned short aImgLength; ° d ONLN d À ú ◊J * /* output image attributes */ ° d ONLN d> Ÿ ú  fi * IpPixelType ° d ONLN dO Ÿ ÂJ )l aPixelType; ° d ONLN d\ Á ú Û fi ( ú RotateAngle ° d ONLN dm Á Û2 )laAngle; ° d ONLN dv ı úP ( ˛ ú /* image banding parameters */ ° d ONLN dñ ú *unsigned short ° d ONLN d™\ )laStartingLine; ° d ONLN d∫ ú ( úunsigned short ° d ONLN dŒ \ )laLinesPerBand; ° d ONLN dfi ú+ à (( úBoolean ° d ONLN dÏ +D )l
firstBand; ° d ONLN d¯- ú9 Ã (6 úBoolean ° d ONLN d-9> )l lastBand; ° d ONLN d; äG ê (D ä} ° d ONLN d; úG ˆ )ImageAttribute;
U Hd 4U Hc
. ° d ONLN d"T ä_ ÷ (\ äField descriptions
ˇ·ˇ‚7^
. ° d ONLN d5a äm ¿ * aImgWidth . ° d ONLN d?a ÊmÅ )\%Horizontal size of image, in pixels. . ° d ONLN dep ä| Δ (y ä
aImgLength . ° d ONLN dpp Ê| Ì )\V ú` ° d ONLN dqp Ï|r )"ertical size of image, in pixels. . ° d ONLN dî äã Δ (à ä
aPixelType . ° d ONLN dü Êãd )\ Color or gray; bits per pixel. . ° d ONLN døã Êó
* kGray8 ° d ONLN d≈ã
óÉ )$ = 8-bit (256 levels of gray) ° d ONLN d„ó Ê£
(† ÊkDIB24 ° d ONLN dÈó
£Ö )$ = 24-bit (16 million colors) ° d ONLN d¶ ä≤ Æ (Ø äaAngle ° d ONLN d¶ Ê≤ö )\(Rotation angle of output image. See the ° d ONLN d7¶ö≤‹ )¥ RotateAngle ° d ONLN dB¶‹≤Í )B str l ° d ONLN dF¶Í≤ )uctur >` ° d ONLN dK¶ ≤ )e . ° d ONLN dM≤ Êæ! (ª Ê
described on °Ä ° d ONLN dZ≤!æ8 );page |` ° d ONLN d_≤9æF )4-6 –@ ° d ONLN db≤FæK )
. . ° d ONLN de¡ äÕ ÿ ( ä
aStartingLine . ° d ONLN ds¡ ÊÕõ )\)Starting line number of the output band. . ° d ONLN dù– ä‹ ÿ (Ÿ ä
aLinesPerBand . ° d ONLN d´– Ê‹Ü )\$Number of full-width lines in band. . ° d ONLN d–fl äÎ ¿ (Ë ä firstBand ° d ONLN d⁄fl ÊÎ )\Set to ° d ONLN d·flÎ ) TRUE ° d ONLN dÂflÎ2 ) for fi ° d ONLN dÏfl2Îë )rst band of an image. ° d ONLN dÓ ä˙ ∫ (˜ älastBand ° d ONLN d Ó Ê˙ )\Set to ° d ONLN dÓ˙ ) TRUE ° d ONLN dÓ˙3 ) for fr R` ° d ONLN d Ó3˙t )ee working buf $¿ ° d ONLN d,Ót˙ä )Afers. ° d ONLN d3ˇ ä • ( äBe sur R` ° d ONLN d9ˇ •  )e to set up the R` ° d ONLN dIˇ  9 )@ImageAttribute R` ° d ONLN dWˇ9 G )T str >` ° d ONLN d[ˇG ] )uctur ¿ ° d ONLN d`ˇ] ¿ )e to disable banded pr „ ° d ONLN dvˇø )bocessing when ° d ONLN dÑ ä ∞ ( ädecompr R` ° d ONLN dã ∞E )& essing thumbnail data. Both the R` ° d ONLN d´ Eì )ï
aStartingLine R` ° d ONLN d∏ ì® )N and R` ° d ONLN dΩ ®ˆ )
aLinesPerBand R` ° d ONLN d ˆˇ )N fi R` ° d ONLN dÕ ˇ ) elds ° d ONLN d“ ä% « (" ämust be set to ° d ONLN d· «% Õ )=0 ° d ONLN d‚ Õ% ), or a call to ° d ONLN dÒ%é )7IpConvertThumbnailToRGB ° d ONLN dé%™ )ä will r R` ° d ONLN d™%À ) eturn a ° d ONLN d& ä2 fi (/ äkCmBadArgError ° d ONLN d%& fi2 Ì )T err R` ° d ONLN d)& Ì2 ˆ )or ï ° d ONLN d+& ı2 ) . For mor g` ° d ONLN d4& 2ú )'e information about decompr 9¿ ° d ONLN dO&ú2 )Äessing thumbnail image ° d ONLN df3 ä? (< ä data, see the description of ° d ONLN dÉ3?ë )}IpConvertThumbnailToRGB ° d ONLN dö3ë?≈ )ä
function on ° d ONLN dß3≈?› )4page ° d ONLN d¨3›? )4-10 ° d ONLN d∞3?ı ). ˇˇnx ° d ONLN d≥E äQ È (N äWhen you display a r @ ° d ONLN d«E ÍQI )`otated image, set the ˇ˛Kh Δ ° d ONLN d›EIQó )_
aStartingLine ˇˇnx Δ ° d ONLN dÍEóQ™ )N and ˇ˛Kh £ ° d ONLN dÔE´Q˘ )
and . ° d ONLN d±ì äü Ó (ú äthe description of the ° d ONLN d»ì Óü` )dIpConvertADPCMToRGB ° d ONLN d€ì`üî )r
function on ° d ONLN dËìîü¨ )4page ° d ONLN dÌì¨ü∫ )4-1 Û` ° d ONLN dìπüæ )
1 Û` ° d ONLN dÒìæü√ ). ˇV @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-6
)B!Image Processing Module Reference 4 ^ *¿¯
j * r¯ 4 j * r¯ l * l˛
ˇ·ˇ‚7^
° d ONLN d \ * j z ( f *Characteristics ˇˇˇˇˇˇ ( fÚ4
ˇˇÃR . ° d ONLN d { l á ( Ñ lThe ,
Courier ˇˇdˆ LR ° d ONLN d { Ä á ⁄ )Characteristics ˇˇÃR LR ° d ONLN d $ { ⁄ á Á )Z str § ° d ONLN d ( { Ë á ˛ )uctur ◊ ° d ONLN d - { ˝ á )e contr u∂ ° d ONLN d 4 { áH )
ols the CR Ø˙ ° d ONLN d > {H á… ).T RGB display phosphor chr ≥¢ ° d ONLN d X {… ᘠ)Å
omaticity . ° d ONLN d b à l î ¨ ( ë l
values and CR p ° d ONLN d o à ¨ î ⁄ )@ T gamma. . ° d ONLN d y ° l ≠, ( ™ l typedef struct characteristics { ° d ONLN d õ Ø ~ ª Æ +XYChroma ° d ONLN d ® Ø ÿ ª )Z
redChroma; ° d ONLN d ¥ Ω ~ … Æ ( Δ ~XYChroma ° d ONLN d ¡ Ω ÿ … )Z greenChroma; ° d ONLN d œ À ~ ◊ Æ ( ‘ ~XYChroma ° d ONLN d ‹ À ÿ ◊ )Z blueChroma; ° d ONLN d È Ÿ ~  ¢ ( ‚ ~double ° d ONLN d Ù Ÿ ÿ  ¸ )Zgamma; ° d ONLN d ˚ Á l Û r ( l} ° d ONLN d ˝ Á ~ Û fi )Characteristics;
*¯ 4 *¯
. ° d ONLN d l ∏ ( lField descriptions
ˇ·ˇ‚7^
. ° d ONLN d!
l ¢ * redChroma . ° d ONLN d+
» )\Red phosphor chr €† ° d ONLN d;
@ )O omaticity ^@ ° d ONLN dD
@E )). . ° d ONLN dG l( Æ (% l greenChroma . ° d ONLN dS »( ” )\Gr Ê ° d ONLN dU ”( ) een phosphor chr ° d ONLN de !(J )N omaticity ï† ° d ONLN dn I(N )(. . ° d ONLN dq+ l7 ® (4 l
blueChroma . ° d ONLN d|+ »7 )\Blue phosphor chr ° d ONLN dç+7C )R omaticity ü¿ ° d ONLN dñ+B7G )(. . ° d ONLN dô: lF ä (C lgamma . ° d ONLN dü: »F ’ )\CR ʆ ° d ONLN d°: ’FN )
T gamma, color temperatur !† ° d ONLN d∫:OFà )ze in Kelvins.
v *~¯ 4v *~¯ x *x˛
ˇ·ˇ‚7^
° d ONLN d…h *v f (r *XYChroma ˇˇˇˇˇˇ (rÚ4
. ° d ONLN d”à lî Ä (ë lThe ° d ONLN d◊à Äî ∞ )XYChroma ° d ONLN dflà ∞î æ )0 str l ° d ONLN d„à æî ‘ )uctur >` ° d ONLN dËà ‘î  )e pr ¿ ° d ONLN dÏà Âî% )
ovides the CR ≤` ° d ONLN d˘à$î‰ )?'T RGB display phosphor and white-point . ° d ONLN d ï l° z (û lchr ܆ ° d ONLN d#ï z° Í )omaticity x and y values. . ° d ONLN d>Æ l∫ (∑ ltypedef struct xyChroma { ° d ONLN dZº ~» ® +double ° d ONLN ddº ¥» Í )6 xChroma; ° d ONLN do ~÷ ® (” ~double ° d ONLN dy ¥÷ Í )6 yChroma; ° d ONLN dÉÿ l‰ r (· l} ° d ONLN dÖÿ ~‰ ¥ ) XYChroma;
Ò * ¯ 4Ú * ¯
. ° d ONLN dèÒ l¸ ∏ (˘ lField descriptions
ˇ·ˇ‚7^
. ° d ONLN d¢˛ l
ñ *xChroma . ° d ONLN d™˛ »
œ )\V Õ ° d ONLN d´˛ Œ
)alue for x chr ÒÄ ° d ONLN dπ˛
1 ): omaticity t ° d ONLN d¬˛1
6 )). . ° d ONLN d≈
l ñ ( lyChroma . ° d ONLN dÕ
» œ )\V Õ ° d ONLN dŒ
Œ )alue for y chr X ° d ONLN d‹
2 ); omaticity ⁄† ° d ONLN dÂ
16 )(.
H *Q¯ 4I *P¯ J *J˛
ˇ·ˇ‚7^
° d ONLN dË; *I n (E * RotateAngle ˇˇˇˇˇˇ (EÚ4
. ° d ONLN dıZ lf Ä (c lThe ° d ONLN d˘Z Äf ¬ ) RotateAngle ° d ONLN dZ ¬f – )B str l ° d ONLN dZ –f Ê )uctur >` ° d ONLN d
Z Êf ˜ )e pr ¿ ° d ONLN dZ ˜f\ )ovides the values for r „ ° d ONLN d(Z[fß )dotating a QuickT ¯ ° d ONLN d8Z¶fË )Kake 100 image . ° d ONLN dFg ls ç (p lcounter @ ° d ONLN dMg és æ )" clockwise. . ° d ONLN dYÄ lå (â ltypedef enum rotateAngle { ° d ONLN d}Ä å⁄ )¥ /* counterclockwise rotation */ ° d ONLN dûé ~ö ÿ (ó ~kImgRot0 = 0, ° d ONLN d∂é ö∞ )¢/* 0-degree rotation */ ° d ONLN d–ú ~® ÿ (• ~kImgRot90 = 1, ° d ONLN dËú ®∞ )¢/* 90-degree rotation */ ˇd @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä!Image Processing Module Reference
, (‡ 4-7 4 ^ H¿ ,
Courier . ° d ONLN d \ ú h ˆ ( e úkImgRot180 = 2, ° d ONLN d \> h‘ )¢/* 180-degree rotation */ ° d ONLN d 3 j ú v ( s úkImgRot270 = 3 ° d ONLN d J j> v‘ )¢/* 270-degree rotation */ ° d ONLN d d x ä Ñ fi ( Å ä} RotateAngle;
ë H † 4 í H †
. ° d ONLN d s ë ä ú ÷ *Field descriptions
ˇ·ˇ‚7^
. ° d ONLN d Ü û ä ™ ∫ *KImgRot0 . ° d ONLN d è û Ê ™ ı )\Zer ∫ ° d ONLN d í û ı ™ )
o (0) degr ‡ ° d ONLN d ú û ™? )+ees of r oÄ ° d ONLN d § û? ™c ) otation. . ° d ONLN d Æ ≠ ä π ¿ ( ∂ ä kImgRot90 . ° d ONLN d ∏ ≠ Ê π )\90 degr 9Ä ° d ONLN d ø ≠ π& )!ees of r ò ° d ONLN d « ≠& πJ ) otation. . ° d ONLN d — º ä » Δ ( ≈ ä
kImgRot180 . ° d ONLN d ‹ º Ê » )\180 degr 9Ä ° d ONLN d ‰ º »+ )&ees of r ò ° d ONLN d Ï º+ »O ) otation. . ° d ONLN d ˆ À ä ◊ Δ ( ‘ ä
kImgRot270 . ° d ONLN d À Ê ◊ )\270 degr 9Ä ° d ONLN d À ◊+ )&ees of r ò ° d ONLN d À+ ◊O ) otation.
H 4 H H
ˇ·ˇ‚7^
° d ONLN d ˘ H ß ( HProgressCallBack ˇˇˇˇˇˇ (4
. ° d ONLN d- ä$ Í (! äProgressCallBack ° d ONLN d= Í$ )`
is the pr R` ° d ONLN dG$C )( ototype str >` ° d ONLN dRC$Y )1uctur ¿ ° d ONLN dWY$∫ )e of an application pr „ ° d ONLN dmπ$« )`ogr µÄ ° d ONLN dp«$ˇ )
ess callback . ° d ONLN d}% ä1 ¥ (. ä
function. . ° d ONLN dà> äJP *!typedef struct ProgressCallBack { ° d ONLN d´L úX\ + IpProgressProcPtr callBackProc; ° d ONLN dÕZ úf ∫ *long ° d ONLN dÿZf2 )lrefcon; ° d ONLN d‡h ät ê (q ä} ° d ONLN d‚h út )ProgressCallBack;
° d ONLN dY≈ H’ ÿ (— HIPM Functions for Micr ˙@ ° d ONLN do≈ ÿ’ )êosoft W & ° d ONLN dv≈’9 )0indows ' ° d ONLN d}≈9’à )1 Applications ˇˇˇˇˇˇ )÷4
° d ONLN dã‹ äËfi ( äKThe IPM functions described in this section perform operations on the compr p` ° d ONLN d÷‹fi˯ (Âfiessed ° d ONLN d‹È äı fi (Ú äimage data that is r 3¿ ° d ONLN dÈ flı
)U etrieved fr ‡ ° d ONLN d˚È
ıO ).
om the QuickT 0@ ° d ONLN dÈNı )A(ake 100 camera. These functions convert ° d ONLN d0ˆ ä ¶ (ˇ äcompr ‡ ° d ONLN d5ˆ ß ‚ ) essed QuickT ™` ° d ONLN dAˆ ·˛ ):?ake 100 images into formats that can be displayed on computers ° d ONLN dÄ ä Ω ( ä capable of r ‘ ° d ONLN då Ω Ù )3 unning Micr Ÿ† ° d ONLN dó Ù )7osoft W ã@ ° d ONLN dûA )" indows. T † ° d ONLN dßAΩ )+ o use these functions, be sur ¨‡ ° d ONLN dƒΩ )|e to include the ° d ONLN d’ ä ¨ ( äipm.h fi † ° d ONLN d› ≠ T )#(le in the include section of your code.
+ H9 4+ H8
° d ONLN d) ä4 ù (1 äNote
ˇ·ˇ‚7^
. ° d ONLN d 6 äB ˇ *All parameter pointers ar R` ° d ONLN d$6 ˇB( )u
e of type R` ° d ONLN d.6(B: ))far R` ° d ONLN d16:Bß ) unless otherwise noted. ,
Zapf Dingbats
. R` ° d ONLN dK9¨A≤ )ru
P H^ 4P H]
° d ONLN dMN äY ù (V äNote
ˇ·ˇ‚7^
° d ONLN dR[ äg *On the Macintosh computer Ù` ° d ONLN dk[g* ){, QuickT Ù‡ ° d ONLN ds[*gx )%ake 100 images ar ‰¿ ° d ONLN dÑ[xg¡ )Ne converted into ° d ONLN dïg äs ≤ (p ä display-r S† ° d ONLN dûg ≤s )(eady PICT format fi « ° d ONLN d±g sM )Wles by a QuickT M` ° d ONLN d¿gMsë )Dake 100 QuickT ° d ONLN dŒgës§ )Dime ° d ONLN d“s ä ± (| ädecompr Ê@ ° d ONLN dŸs ± « )'essor ‘† ° d ONLN dfis « ). Converted QuickT =@ ° d ONLN ds l )Wake 100 images ar - ° d ONLN dsl± )Ne shown on the ° d ONLN d äã∫ (à äBMacintosh display using the same techniques used to display PICT fi ‹@ ° d ONLN dS∫ã» (à∫les ° d ONLN dWã äó ¡ (î ä with QuickT ≤ ° d ONLN dbã ¡ó )7ime or QuickDraw Ü¿ ° d ONLN drãó )R.
Ü¿ ° d ONLN dué ñ# )
u ˇ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-8
)B!Image Processing Module Reference 4 ^ *¿¯
j * r¯ 4 j * r¯ l * l˛
ˇ·ˇ‚7^
° d ONLN d \ * j a ( f * IpInitIPM ˇˇˇˇˇˇ ( fÚ4 ,
Courier
. ° d ONLN d { l ᧠( Ñ l4OSErr FAR PASCAL IpInitIPM(unsigned char far * ipm); ° d ONLN d @ ì l ü ~ *ipm . ° d ONLN d D ì Æ ü ≈ )BAddr C¿ ° d ONLN d H ì Δ üâ ).ess that will contain the IPM private data str ß ° d ONLN d v ìâ ü† )√uctur - ° d ONLN d { ì° üà ) es for the ° d ONLN d Ü ü Æ ´ ( ® Æapplication. This ar ì` ° d ONLN d ö ü ´‰ )U2ea of memory must be allocated by the application ° d ONLN d à ´ Æ ∑ ≈ ( ¥ Æbefor _† ° d ONLN d — ´ ≈ ∑J )!e this function is called. Be sur *‡ ° d ONLN d Ú ´K ∑ï )Üe this memory ar €Ä ° d ONLN d ´ï ∑fl )Jea has been clear ° d ONLN d ´‡ ∑Ì )Ked . ° d ONLN d ∑ Æ √ Ù ( ¿ Æprior to calling ° d ONLN d' ∑ Ù √* )F IpInitIPM ° d ONLN d0 ∑* √ß )6 . The size of this memory ar R` ° d ONLN dL ∑ß √– )} ea is defi R` ° d ONLN dV ∑– √Ô ))ned by ° d ONLN d] √ Æ œ Á ( à Æ
the constant ° d ONLN dj √ Á œA )9kIPMContextSize ° d ONLN dy √A œF )Z.
. ° d ONLN d| È * Ú c ( * DESCRIPTION
. ° d ONLN dà ˆ l Ä +BThe ° d ONLN då ˆ Ä ∂ ) IpInitIPM ° d ONLN dï ˆ ∂Ê )6F function initializes the IPM. This function must be called once befor R` ° d ONLN d€ ˆÊÌ ( ˇÊe . ° d ONLN d› l ± ( lany other IPM r H` ° d ONLN dÏ ≤ › )F
outines ar ¿ ° d ONLN dˆ fi{ ),&e called. During the initialization pr ∞` ° d ONLN d {∞ )ù ocess IPM fi √‡ ° d ONLN d(∞ı )5lls in the image ° d ONLN d9 l u ( lpr G ° d ONLN d; v ø )
ocessing data str uÄ ° d ONLN dL ø ÷ )Iuctur ˚` ° d ONLN dQ ÷ ◊ );es with default settings for the camera matrix and display ° d ONLN då l) ÿ (& lcharacteristics. However ≠ ° d ONLN d§ ÿ) )l, the values ar · ° d ONLN d≥ )∫ )=*e not actually set prior to a call to the . ° d ONLN d›* l6 (3 lIpCalculateColorTables ° d ONLN dÛ* 61 )Ñ function. Ther R` ° d ONLN d*16C )Aefor $¿ ° d ONLN d*C6z )
e, you must f ı@ ° d ONLN d*y6± )6irst call the ı@ ° d ONLN d!*±6Á )8 IpInitIPM ı@ ° d ONLN d**Á6È )6 ° d ONLN d+7 lC – (@ lfunction and then call ° d ONLN dB7 –CT )dIpCalculateColorTables ° d ONLN dX7TCm )Ñ befor R` ° d ONLN d^7mCØ )e any image pr $¿ ° d ONLN dl7ØCÊ )B
ocessing can . ° d ONLN dyD lP ù (M l take place. ° d ONLN dÜV lbÛ *[If you change the settings for the default camera color matrix and display characteristics ° d ONLN d·c lo> *
/during a session with the IPM, those changes ar ¿ ° d ONLN dc?o– )”#e not actually put to use until an . ° d ONLN d3p l| (y lIpCalculateColorTables ° d ONLN dIp |D )Ñ function is called.
. ° d ONLN d_ó *† D (û *RESUL ëÄ ° d ONLN ddó D† h )T CODES
. ° d ONLN dl§ l∞) +(+Upon successful completion, this function r R` ° d ONLN dó§)∞F )Ωeturns R` ° d ONLN dû§F∞d ) noErr R` ° d ONLN d£§d∞ ) and the IPM initializes the . ° d ONLN d¿± lΩ fl (∫ lnecessary internal data str ˛‡ ° d ONLN d€± flΩ ˆ )suctur Ñ¿ ° d ONLN d‡± ˜Ω™ )*es for use by subsequent function calls fr · ° d ONLN d
±™ΩÀ )≥om the ° d ONLN dæ l ¢ (« l
application. ° d ONLN d – l‹ è * If an err Ö ° d ONLN d(– è‹
)# or is detected, this function r ®@ ° d ONLN dG–
ess of an ° d ONLN dßË2Ù (Ò2invalid data item. . ° d ONLN d∫Û lˇ Í (¸ lkIpContextExistsError ° d ONLN d—Û2ˇp )Δ The memory r R` ° d ONLN d›ÛpˇÇ )>efer $¿ ° d ONLN d·Ûǡº )
enced by the $¿ ° d ONLN dÓÛºˇŒ ):ipm $¿ ° d ONLN dÒÛŒˇ– ) . ° d ONLN dÚ˛2
(2parameter has alr ÿ ° d ONLN d˛
Ì )Meady been allocated by a . ° d ONLN d 2< (2pr R` ° d ONLN d <z )
evious call to R` ° d ONLN d- z∞ )> IpInitIPM R` ° d ONLN d6 ∞µ )6. ° d ONLN d9 l à ( lkIpNoMemoryError . ° d ONLN dK2 Ê )Δ'System failed to allocate system memory ¶Ä ° d ONLN drÂ Í )≥.
° d ONLN du9 *B Q (@ *SEE ALSO
. ° d ONLN d~F lR ú +BIpEndIPM ° d ONLN dÜF úR Ê )0, described next; ° d ONLN dòF ÊRj )JIpCalculateColorTables ° d ONLN dÆFjRx )Ñ on ° d ONLN d≤FxRê )page ° d ONLN d∑FêRû )4-9 ˇx @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä!Image Processing Module Reference
, (‡ 4-9 4 ^ H¿
j H r 4 j H r l H l
ˇ·ˇ‚7^
° d ONLN d \ H j Å ( f HIpEndIPM ˇˇˇˇˇˇ ( f4 ,
Courier
. ° d ONLN d
{ ä Ạ( Ñ ä3OSErr FAR PASCAL IpEndIPM(unsigned char far * ipm); ° d ONLN d > ì ä ü ú *ipm . ° d ONLN d B ì à ü „ )BAddr C¿ ° d ONLN d F ì ‰ üæ )3ess of the private storage for the IPM. See the defi ó ° d ONLN d z ìæ üˆ )⁄nition of the . ° d ONLN d à ü à ´ ( ® à IpInitIPM ° d ONLN d ë ü ´6 )6
function on ° d ONLN d û ü6 ´N )4page ° d ONLN d £ üN ´\ )4-8 ° d ONLN d ¶ ü\ ´~ ) for mor R` ° d ONLN d Æ ü~ ´Í )"e information about the R` ° d ONLN d Δ üÍ ´¸ )lipm R` ° d ONLN d … ü¸ ´˛ ) . ° d ONLN d ´ à ∑ ˘ ( ¥ à parameter S† ° d ONLN d ” ´ ˘ ∑ ˛ )-.
° d ONLN d ÷ — H ⁄ Å ( ÿ H DESCRIPTION
. ° d ONLN d ‚ fi ä Í û +BThe ° d ONLN d Ê fi û Í Œ )IpEndIPM ° d ONLN d Ó fi Œ Í )0E function closes the IPM and deallocates associated memory allocated ° d ONLN d3 Î ä ˜ µ ( Ù ä with the ° d ONLN d< Î µ ˜ Î )+ IpInitIPM ° d ONLN dE Î Î ˜* )6 function. The ° d ONLN dT Î* ˜Z )?IpEndIPM ° d ONLN d\ ÎZ ˜ )0' function should always be called befor R` ° d ONLN dÉ Î ˜ )Øe . ° d ONLN dÖ ¯ ä( ( ä%exiting the IPM. The application is r }† ° d ONLN d™ ¯( )û3esponsible for disposing of any application memory ° d ONLN d› ä ( ä associated with using the IPM.
° d ONLN d¸, H5 b (3 HRESUL ëÄ ° d ONLN d, b5 Ü )T CODES
. ° d ONLN d 9 äE À +(This function r R` ° d ONLN d9 ÀE )Aeturns the value R` ° d ONLN d)9E4 )KnoErr R` ° d ONLN d.94EØ ) upon successful completion. . ° d ONLN dKK äW ≠ (T ä If an err Ö ° d ONLN dTK ≠W+ )# or is detected, this function r ®@ ° d ONLN dsK+Wü )~eturns one of these values: . ° d ONLN dèX äd fi (a äkIpBadArgError . ° d ONLN düXPdfl )Δ Parameter is or contains an addr ‰ ° d ONLN døXfld )è
ess of an ° d ONLN d…cPoù (lPinvalid data item. . ° d ONLN d‹n äz (w äkIpNoContextExistsError . ° d ONLN dınPzÙ )Δ%This function was called without a pr 9` ° d ONLN dnız )•evious . ° d ONLN d!yPÖo (ÇPcall to ° d ONLN d)yoÖ• ) IpInitIPM ° d ONLN d2y•Ö™ )6.
. ° d ONLN d5û Hß o (• HSEE ALSO
. ° d ONLN d>´ ä∑ ¿ +B IpInitIPM ° d ONLN dG´ ¿∑ Œ )6 on ° d ONLN dK´ Œ∑ Ê )page ° d ONLN dP´ Ê∑ Ù )4-8
Ë H 4Ë H Í HÍ
ˇ·ˇ‚7^
. ° d ONLN dT⁄ HË ≠ (‰ HIpCalculateColorT "Ä ° d ONLN de⁄ ≠Ë … )eables ˇˇˇˇˇˇ (‰4
. ° d ONLN dl˙ ä ( äAOSErr FAR PASCAL IpCalculateColorTables(unsigned char far * ipm); ° d ONLN dÆ ä ú *ipm . ° d ONLN d≤ Ã ë )B,Pointer to the memory allocated for the IPM.
° d ONLN dí √ * à D ( *RESUL ëÄ ° d ONLN dó √ D à h )T CODES
. ° d ONLN dü — l › ≠ +(This function r R` ° d ONLN dÆ — ≠ › )Aeturns R` ° d ONLN dµ — › Ë ) noErr R` ° d ONLN d∫ — Ë ›c ) upon successful completion. ˇˇÀh ° d ONLN d◊ „ l Ô è ( Ï l If an err È0 ° d ONLN d‡ „ è Ô œ )#or is detected, ˇˇb8 Kh ° d ONLN d „ – ÔT )AIpCalculateColorTables ˇˇÀh Kh ° d ONLN d „T ÔY )Ñ r È0 ° d ONLN d „Y ÔÔ )#eturns one of the values listed her ° d ONLN d+ „ Ô¯ )óe: ° d ONLN d. l ¸ ¿ ( ˘ lkIpBadArgError . ° d ONLN d> 2 ¸¡ )Δ Parameter is or contains an addr ‰ ° d ONLN d^ ¡ ¸È )è
ess of an ° d ONLN dh ˚2 (2invalid data item. . ° d ONLN d{ l ˆ ( lkIpNoContextExistsError ° d ONLN dî2F )ΔThe ° d ONLN dòFX )ipm ° d ONLN dõXÛ )# parameter does not point to valid . ° d ONLN dæ2 G (2data.
° d ONLN dƒ5 *> Q (< *SEE ALSO
. ° d ONLN dÕC lO ¢ +B IpInitIPM ° d ONLN d÷C ¢O ∞ )6 on ° d ONLN d⁄C ∞O » )page ° d ONLN dflC »O ÷ )4-8 ° d ONLN d‚C ÷O € ), ° d ONLN d‰C €O} )IpSetDisplayCharacteristics ° d ONLN dˇC}Oã )¢ on ° d ONLN dCãO£ )page ° d ONLN dC£O∂ )4-14 ° d ONLN d C∂OΩ ), ° d ONLN dP l\ (Y l IpInitDisplayCharacteristics ° d ONLN d+P\" )® on ° d ONLN d/P"\: )page ° d ONLN d4P:\M )4-15 ° d ONLN d8PM\R ), ° d ONLN d:PR\÷ )IpSetCameraColorMatrix ° d ONLN dPP÷\‰ )Ñ on ° d ONLN dT] li Ñ (f lpage ° d ONLN dY] Ñi ó )4-17 ° d ONLN d]] ói ú ), ° d ONLN d_] úi& )IpInitCameraColorMatrix ° d ONLN dv]&i7 )ä, on ° d ONLN d{]7iO )page ° d ONLN dÄ]Oib )4-17 ° d ONLN dÑ]bid )
ô *¢¯ 4ö *°¯ õ *õ˛
ˇ·ˇ‚7^
. ° d ONLN dÜå *ö ß (ñ *IpConvertThumbnailT $¿ ° d ONLN dôå ßö » )}oRGB ˇˇˇˇˇˇ (ñÚ4
. ° d ONLN dü´ l∑Ú (¥ lAOSErr FAR PASCAL IpConvertThumbnailToRGB(unsigned char far * ipm, ° d ONLN dËπ Í≈∞ +~!unsigned char far * pCompedTNail, ° d ONLN d« Í”û * unsigned char far * pTNailRGB, ° d ONLN d7’ Í·û * ImageAttribute far * imgAttr); ° d ONLN dVÌ l˘ ~ (ˆ lipm . ° d ONLN dZÌ Æ˘s )B,Pointer to the memory allocated for the IPM. . ° d ONLN dá˝ l ¥ ( l pCompedTNail . ° d ONLN dî Æ +B Pointer to the compr M† ° d ONLN d® q )[essed thumbnail image. . ° d ONLN dø l% ¢ (" l pTNailRGB . ° d ONLN d… Æ%A )B Pointer to the output RGB image. . ° d ONLN dÍ) l5 ñ (2 limgAttr ° d ONLN dÚ) Æ5 Ó )BPointer to the ° d ONLN d) Ó5B )@ImageAttribute ° d ONLN d)B5h )T data str l ° d ONLN d)h5~ )&uctur >` ° d ONLN d )~5˜ )e that describes the image ° d ONLN d85 ÆA ≤ (> Ær R` ° d ONLN d95 ≤A ƒ )efer $¿ ° d ONLN d=5 ƒA Í ) enced in $¿ ° d ONLN dF5 ÍA2 )& pCompedTNail $¿ ° d ONLN dR52AÑ )H. Banded image pr ˜ ° d ONLN dc5ÉAÌ )Qocessing does not apply ° d ONLN d{A ÆM+ (J Æto thumbnail images. Be sur R` ° d ONLN dñA+M^ )}
e to set the R` ° d ONLN d£A^M¨ )3
aStartingLine R` ° d ONLN d∞A¨M¡ )N and ° d ONLN dµM ÆY ¸ (V Æ
aLinesPerBand ° d ONLN d¬M ¸Y )N f PÄ ° d ONLN dƒMY8 )
ields in the PÄ ° d ONLN d—M8Yå )6ImageAttribute PÄ ° d ONLN dflMåYö )T str <Ä ° d ONLN d„MöY∞ )uctur ‡ ° d ONLN dËM∞Y¬ )e to ‡ ° d ONLN dÌM¬Y» )0 ‡ ° d ONLN dÓM»YÂ ) when . ° d ONLN dÙY Æe ∑ (b Æpr G ° d ONLN dˆY ∏e4 )
ocessing thumbnail images.
° d ONLN d *à c (Ü * DESCRIPTION
. ° d ONLN d å lò Ä +BThe ° d ONLN d"å Äò
)IpConvertThumbnailToRGB ° d ONLN d9å
òX )ä function decompr R` ° d ONLN dJåXò€ )N esses a thumbnail image and ˇˇã4 ° d ONLN dfô l• v (¢ lpr R` ° d ONLN dhô v• ã )
epar $¿ ° d ONLN dlô ã• ¸ )es it for display as specifi ‹ƒ ° d ONLN dàô ¸•& )q
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä!Image Processing Module Reference
äÄ (‡4-1 )
1 4 ^ H¿
° d ONLN d \ H e b ( c HRESUL ëÄ ° d ONLN d \ b e Ü )T CODES
. ° d ONLN d
j ä v À +(This function r R` ° d ONLN d j À v Ë )Aeturns ,
Courier R` ° d ONLN d # j Ë v ) noErr R` ° d ONLN d ( j vÅ ) upon successful completion. . ° d ONLN d E | ä à ≠ ( Ö ä If an err Ö ° d ONLN d N | ≠ à+ )# or is detected, this function r ®@ ° d ONLN d m |+ à¿ )~#eturns one of the values listed her •Ä ° d ONLN d ê |¿ à« )ïe: . ° d ONLN d ì â ä ï fi ( í äkIpBadArgError . ° d ONLN d £ âP ïfl )Δ Parameter is or contains an addr ‰ ° d ONLN d √ âfl ï )è
ess of an ° d ONLN d Õ îP †ù ( ùPinvalid data item. . ° d ONLN d ‡ ü ä ´, ( ® äkIpColorTablesNotCalculated . ° d ONLN d ˝ üP ´∞ )ΔColor parameters wer † ° d ONLN d ü± ´Û )ae initialized or ° d ONLN d" ™P ∂ ( ≥P(changed without calculating the derived ° d ONLN dJ µP ¡r * color pr ˝` ° d ONLN dR µr ¡∏ )"ocessing tables. { ° d ONLN dc µπ ¡ø )GY ;Ä ° d ONLN dd µø ¡˜ )
ou must call . ° d ONLN dq ¿P Ñ ( …PIpCalculateColorTables ° d ONLN dá ¿‘ ÃÌ )Ñ befor R` ° d ONLN dç ¿Ì Ã )e image . ° d ONLN dï ÀP ◊Y ( ‘Ppr G ° d ONLN dó ÀZ ◊¬ )
ocessing can take place. . ° d ONLN d∞ ÷ ä ‚ ( fl äkIpNoContextExistsError ° d ONLN d… ÷P ‚b )ΔThe ° d ONLN dà ÷b ‚d ) ° d ONLN dÕ ÷d ‚v )ipm ° d ONLN d– ÷v ‚ )# parameter does not point to valid . ° d ONLN dÛ ·P Ìe ( ÍPdata. . ° d ONLN d˘ Ï ä ¯ Í ( ı äkIpNoMemoryError . ° d ONLN d ÏP ¯‚ )Δ System failed to allocate memory =` ° d ONLN d+ Ï‚ ¯Á )í.
° d ONLN d. H o ( HSEE ALSO
. ° d ONLN d7 ä* ¿ +B IpInitIPM ° d ONLN d@ ¿* Œ )6 on ° d ONLN dD Œ* Ê )page ° d ONLN dI Ê* Ù )4-8 ° d ONLN dL Ù* ˘ ), ° d ONLN dN ˘*} )IpCalculateColorTables ° d ONLN dd }*ã )Ñ on ° d ONLN dh ã*£ )page ° d ONLN dm £*± )4-9
Z Hc 4[ Hb \ H\
ˇ·ˇ‚7^
. ° d ONLN dqM H[ ‘ (W HIpConvertADPCMtoRGB ˇˇˇˇˇˇ (W4
. ° d ONLN dÜl äx¯ (u ä=OSErr FAR PASCAL IpConvertADPCMtoRGB(unsigned char far * ipm, ° d ONLN dÀzÜ» +~ unsigned char huge * pCompedCDI, ° d ONLN dÛàî™ *unsigned char huge * pRGB, ° d ONLN dñ¢∂ * ImageAttribute far * imgAttr, ° d ONLN d;§∞Ê *%ProgressCallBack far * callBackProc); ° d ONLN daº ä» ú (≈ äipm . ° d ONLN deº ûî )B-Pointer to the memory allocated for the IPM. . ° d ONLN dìà äÿ Δ (’ ä
pCompedCDI . ° d ONLN dûÿ É+ +B Pointer to the QuickT Õ@ ° d ONLN d≥ÿ*‰j )^
Ãoutput images r R` ° d ONLN d`# )Eefer $¿ ° d ONLN dd#K ) enced by $¿ ° d ONLN dmKá )(
pCompedCDI $¿ ° d ONLN dwáú )< and $¿ ° d ONLN d|ú¥ )pRGB $¿ ° d ONLN dÄ¥Ω ), r ˜ ° d ONLN dÉºÒ ) espectively €` ° d ONLN dé )4. When . ° d ONLN dï à œ ( Ãr E ° d ONLN dñ – Q ) otating images 90 or 270 degr ˚‡ ° d ONLN d≥Q œ )Åees without using banded pr åÄ ° d ONLN dŒ–
)ocessing, the . ° d ONLN d‹ Ã( (% Ã
aLinesPerBand ° d ONLN dÈ ( )N f PÄ ° d ONLN dÎ (R ) ield in the PÄ ° d ONLN d˜ R(¶ )2ImageAttribute PÄ ° d ONLN d ¶(¥ )T str <Ä ° d ONLN d ¥( )uctur ‡ ° d ONLN d ( )e must be set to . ° d ONLN d ( Ã4 ‡ (1 Ãthe r ¢` ° d ONLN d$( ‡4ñ )*otated image height (either 640 for high-r Ç` ° d ONLN dN(ñ4 )∂ esolution images or 320 for ° d ONLN dj4 Ã@ Ì (= Ãstandar ±Ä ° d ONLN dq4 Ì@ ˙ )!d-r Ê ° d ONLN dt4 ˙@¥ )
'esolution images). When doing banded pr — ° d ONLN dõ4¥@ )∫ocessing at 90 or 270 ° d ONLN d±@ ÃL ‡ (I Ãdegr πÄ ° d ONLN dµ@ ‡L
) ees, be sur d ° d ONLN d¿@Lc ).e to continue the pr ° d ONLN d‘@dLä )V ocess thr ê@ ° d ONLN d›@äL… )&ough the full r ªÄ ° d ONLN dÏ@…L )?
otated image ° d ONLN d˘L ÃX Ì (U Ãheight. . ° d ONLN d\ äh “ (e ä callBackProc . ° d ONLN dh Ãt „ +B Addr C¿ ° d ONLN dh ‰t6 )ess of a callback pr fl‡ ° d ONLN d'h6tT )Rocedur w ° d ONLN d-hUtk ) e to r Ω† ° d ONLN d3hktí ) eceive pr `Ä ° d ONLN d<hìt° )(ogr * ° d ONLN d?h¢tŒ ) ess status.
° d ONLN dKé Hó Å (ï H DESCRIPTION
. ° d ONLN dWõ äß û +BThe ° d ONLN d[õ ûß )IpConvertADPCMtoRGB ° d ONLN dnõß^ )r function decompr R` ° d ONLN dõ^ßÉ )N esses an Ù ° d ONLN dàõÇßÀ )$ ADPCM QuickT ° d ONLN dîõÀß
)Iake 100 image ° d ONLN d¢® ä¥ ˚ (± äand converts it, as specifi ° d ONLN dΩ® ˚¥' )q
ed by the ° d ONLN d«®'¥{ ),ImageAttribute ° d ONLN d’®{¥â )T str l ° d ONLN dŸ®â¥ü )uctur >` ° d ONLN dfi®ü¥Ë )e, to a display-r ¿ ° d ONLN dԮ˥ )Ieady ˇΔ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-12
)B!Image Processing Module Reference 4 ^ *¿¯
. ° d ONLN d \ l h ı ( e l format. The image is color corr R` ° d ONLN d \ ı h` )âected for display (color ,
Courier R` ° d ONLN d 8 \` h® )k IpPixelTypes R` ° d ONLN d D \® h€ )H only). The ° d ONLN d P i l u p ( r lr R` ° d ONLN d Q i p u œ )esulting image is stor $¿ ° d ONLN d g i œ u )_ed at the addr ˜ ° d ONLN d u i u< )@
ess specifi ˜ ° d ONLN d Ä i< uf )-
ed in the ˜ ° d ONLN d ä if u~ )*pRGB ˜ ° d ONLN d é i~ u∞ )
parameter 9¿ ° d ONLN d ò i∞ uµ )2.
. ° d ONLN d õ è * ò D ( ñ *RESUL ëÄ ° d ONLN d † è D ò h )T CODES
ess of an ° d ONLN d¶ ›2 È ( Ê2invalid data item. . ° d ONLN dπ Ë l Ù ( Ò lkIpColorTablesNotCalculated . ° d ONLN d÷ Ë2 Ùí )ΔColor parameters wer † ° d ONLN dÍ Ëì Ù’ )ae initialized or ° d ONLN d˚ Û2 ˇÁ ( ¸2(changed without calculating the derived ° d ONLN d# ˛2
T * color pr ˝` ° d ONLN d+ ˛T
ö )"ocessing tables. { ° d ONLN d< ˛õ
° )GY ;Ä ° d ONLN d= ˛°
Ÿ )
ou must call . ° d ONLN dJ 2∂ (2IpCalculateColorTables ° d ONLN d` ∂œ )Ñ befor R` ° d ONLN df œÙ )e image . ° d ONLN dn2 ; ( 2pr G ° d ONLN dp< § )
. ° d ONLN d?µ l¡⁄ (æ l=typedef OSErr (FAR PASCAL *IpProgressProcPtr) (short message, ° d ONLN dá√ œ§ +¥short percentComplete, ° d ONLN d®— ›t *long refcon); ° d ONLN d∂—t›z )T ° d ONLN d∏È lı ñ (Ú lmessage ° d ONLN d¿È Æı )BIndicates the r R` ° d ONLN dœÈ ıK )Beason for the call. V g` ° d ONLN d‰ÈJıï )Zalid messages ar 9¿ ° d ONLN dÙÈïıú )Ke 9¿ ° d ONLN dˆÈúı )IpProgressInit 9¿ ° d ONLN dÈıı )T, ° d ONLN dı Æ (˛ ÆIpProgressUpdate ° d ONLN dı& )`, and ° d ONLN d ı&t )
IpProgressEnd ° d ONLN d)ıtç )N. The ° d ONLN d/ıç· )IpProgressInit ° d ONLN d=ı·ˆ )T and ° d ONLN dB Æ
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä!Image Processing Module Reference
, (‡4-13 4 ^ H¿ . ° d ONLN d \ ä h ß ( e äto the ,
Courier ° d ONLN d \ ß h ) IpConvertADPCMtoRGB ° d ONLN d \ hé )r function, that callback pr R` ° d ONLN d 5 \é h´ )uocedur $¿ ° d ONLN d ; \´ hÛ ) e will be called . ° d ONLN d L i ä u ( r ä periodically as the image is pr Ä ° d ONLN d k i uH )Ö
ocessed to pr ö@ ° d ONLN d x iH ut )9
ovide a pr J‡ ° d ONLN d Ç iu uÉ )-ogr Ä ° d ONLN d Ö iÑ u )"ess indicator to the application. ° d ONLN d ß v ä Ç ( ä The application may choose to fi Õ† ° d ONLN d « v ÇØ )è%lter the callback status to the desir ƒ‡ ° d ONLN d Ï vØ ÇÎ )ñed level and r ʆ ° d ONLN d ˙ vÎ Ç )<eturn ° d ONLN d É ä è π ( å ä
. ° d ONLN d3 ∑ ä √ À +(This function r R` ° d ONLN dB ∑ À √ Ë )Aeturns R` ° d ONLN dI ∑ Ë √ ) noErr R` ° d ONLN dN ∑ √k ) as long as the asynchr $¿ ° d ONLN de ∑k √ )e%onous operation is successful. If an . ° d ONLN dä ƒ ä – ñ ( Õ äerr @ ° d ONLN dç ƒ ó –s )
4or is detected during the operation, this function r Ö¿ ° d ONLN d¡ ƒs – )‹#eturns one of the values listed her É ° d ONLN d‰ ƒ – )ïe: . ° d ONLN dÁ — ä › fi ( ⁄ äkIpBadArgError . ° d ONLN d˜ —P ›õ )ΔThe application r ∑† ° d ONLN d —õ ›Ó )Keceived an invalid ° d ONLN d ‹P Ë} ( ÂP parameter S† ° d ONLN d$ ‹} Ë )-. . ° d ONLN d& Á ä Û ¿ ( ä kIpCancel . ° d ONLN d1 ÁP Û¯ )Δ&The application wants to cancel the pr Z† ° d ONLN dW Á¯ Û )®ocess. ° d ONLN d^ ÚP ˛Ÿ ( ˚P The IPM will discontinue its pr ù@ ° d ONLN d} ÚŸ ˛ )â
ocess and . ° d ONLN dá ˝P T (Pr R` ° d ONLN dà ˝T õ )eturn the value R` ° d ONLN dò ˝õ „ )G kIpAppCancel R` ° d ONLN d§ ˝„ Ë )H.
. ° d ONLN dß! H* o (( HSEE ALSO
. ° d ONLN d∞/ ä; ¸ +BIpConvertADPCMtoRGB ° d ONLN d√/ ¸;
)r on ° d ONLN d«/
;" )page ° d ONLN dÃ/";0 )4-1 Û` ° d ONLN dœ//;4 )
. ° d ONLN dÓ} äâ8 (Ü ä OSErr FAR PASCAL IpGetDisplay ° d ONLN d }8âí )ÆCharacteristics ° d ONLN d#ãó∞ (î(unsigned char far * ipm, ° d ONLN dEô• *'Characteristics far * characteristics); ° d ONLN dm± äΩ ú (∫ äipm . ° d ONLN dq± ÃΩî )B-Pointer to the memory allocated for the IPM. . ° d ONLN dü¡ äÕ ‰ ( ächaracteristics ° d ONLN dØÕ ÃŸ +B Pointer to the ° d ONLN dæÕ Ÿf )@Characteristics ° d ONLN dÕÕfŸt )Z str l ° d ONLN d—ÕtŸä )uctur >` ° d ONLN d÷ÕäŸ√ )e for the curr ¿ ° d ONLN d‰Õ√Ÿ˜ )9 ent display ı ° d ONLN dÔÕıŸ )2. For . ° d ONLN dıŸ ÃÂR (‚ à information about the values r ¿¿ ° d ONLN dŸR‚ )Ü"eturned by this function, see the . ° d ONLN d5 ÃÒ (Ó Ãdescription of the ° d ONLN dH Òx )RCharacteristics ° d ONLN dWÂxÒû )Z data str l ° d ONLN d`ÂûÒ¥ )&uctur >` ° d ONLN deÂ¥Ò« )e on >` ° d ONLN dj«Òfl )page >` ° d ONLN doÂflÒÌ )4-6 >` ° d ONLN drÂÌÒÚ ).
. ° d ONLN du H Å ( H DESCRIPTION
. ° d ONLN dÅ ä$ û +BThe ° d ONLN dÖ û$@ )IpGetDisplayCharacteristics ° d ONLN d†@$l )¢ function r R` ° d ONLN d´l$¨ ),eturns the curr $¿ ° d ONLN d∫¨$ )@ent CR Δ` ° d ONLN d¿…$˜ )
T display ° d ONLN d % ä1 ˜ (. ächaracteristics in the ar R` ° d ONLN d„% ˜1S )mea pointed to by the R` ° d ONLN d¯%S1≠ )\characteristics R` ° d ONLN d%≠1fl )Z
parameter ï ° d ONLN d%fi1„ )1.
. ° d ONLN dL HU b (S HRESUL ëÄ ° d ONLN dL bU Ü )T CODES
. ° d ONLN d!Y äe À +(This function r R` ° d ONLN d0Y Àe Ë )Aeturns R` ° d ONLN d7Y Ëe ) noErr R` ° d ONLN d<YeÅ ) upon successful completion. . ° d ONLN dYk äw ≠ (t ä If an err Ö ° d ONLN dbk ≠w+ )# or is detected, this function r ®@ ° d ONLN dÅk+wü )~eturns one of these values: . ° d ONLN dùx äÑ fi (Å äkIpBadArgError . ° d ONLN d≠xPÑõ )ΔThe application r ∑† ° d ONLN dæxõÑÓ )Keceived an invalid ° d ONLN d—ÉPè} (åP parameter S† ° d ONLN d⁄É}è )-. . ° d ONLN d‹é äö (ó äkIpNoContextExistsError ° d ONLN dıéPöd )ΔThe ° d ONLN d˘édöv )ipm ° d ONLN d¸évö )# parameter does not point to valid . ° d ONLN d ôP•e (¢Pdata. ˇt @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-14
)B!Image Processing Module Reference 4 ^ *¿¯
° d ONLN d \ * e Q ( c *SEE ALSO ,
Courier
. ° d ONLN d j l v +BIpSetDisplayCharacteristics ° d ONLN d $ j vX )¢, described next; ° d ONLN d 6 w l É ( Ä l IpInitDisplayCharacteristics ° d ONLN d R w É" )® on ° d ONLN d V w" É: )page ° d ONLN d [ w: ÉM )4-15
≥ * º¯ 4 ¥ * ª¯ µ * µ˛
ˇ·ˇ‚7^
. ° d ONLN d ` ¶ * ¥ √ ( ∞ *IpSetDisplayCharacteristics ˇˇˇˇˇˇ ( ∞Ú4
. ° d ONLN d } ≈ l — ( Œ l OSErr FAR PASCAL IpSetDisplay ° d ONLN d ö ≈ —t )ÆCharacteristics ° d ONLN d ≤ ” ¸ flí ( ‹ ¸(unsigned char far * ipm, ° d ONLN d ‘ · ¸ ÌÊ *'Characteristics far * characteristics); ° d ONLN d ¸ ˘ l ~ ( lipm . ° d ONLN d ˘ Æs )B,Pointer to the memory allocated for the IPM. . ° d ONLN d- l Δ ( lcharacteristics . ° d ONLN d= Æ!q +B .Pointer to the new display characteristics str ¯ ° d ONLN dkq!à )√uctur }‡ ° d ONLN dpâ!í )e. È ° d ONLN dsí!ı ) All supported display ° d ONLN dâ! Æ-õ (* Æ8characteristics must be set when calling this function. ¸@ ° d ONLN d¡!õ-° )ÌY º¿ ° d ONLN d¬!°-” ) ou should r çÄ ° d ONLN dÕ!‘-Ù )3etrieve ° d ONLN d’- Æ9 (6 Æthe characteristics fi
† ° d ONLN dÎ-9∏ )X(rst, then modify them as necessary befor z† ° d ONLN d-∏9„ )≤
° d ONLN dî l†B +B2This function sets the values for a new color corr ß ° d ONLN dAîB†” )÷ ection matrix using the given CR v` ° d ONLN da€ )ëT ° d ONLN dc° l≠j (™ l=display characteristics. It is used to customize the color pr O‡ ° d ONLN d†°k≠Δ )ˇocessing of a QuickT ° d ONLN d¥°Δ≠È )[ake 100 ° d ONLN dºÆ l∫ ‹ (∑ limage for accurate color r 2† ° d ONLN d÷Æ ›∫ Î )qepr √` ° d ONLN dŸÆ Î∫/ )oduction on dif Ƈ ° d ONLN dËÆ/∫; )Dfer ë` ° d ONLN dÎÆ;∫} ) ent display har ø‡ ° d ONLN d˙Æ}∫î )Bdwar ˜† ° d ONLN d˛Æî∫ù )e. ˇˇUT . ° d ONLN d¿ lÃ ß (… lAfter calling ˇ˝ˇ¸ *® ° d ONLN d¿ ®ÃJ )<IpSetDisplayCharacteristics ˇˇUT *® ° d ONLN d+¿JÃr )¢ , call the ˇ˝ˇ¸ *§ ° d ONLN d6¿sØ ))IpCalculateColorTables ˇˇUT *§ ° d ONLN dL¿˜Ã¯ )Ñ . ° d ONLN dMÕ lŸ (÷ lZfunction to calculate and initialize the new display characteristics for subsequent image . ° d ONLN dß⁄ lÊ v *
ocessing. The R` ° d ONLN d∑⁄ ≥Ê7 )=IpCalculateColorTables R` ° d ONLN dÕ⁄7Ê¢ )Ñ function is described on R` ° d ONLN dÁ⁄¢Ê∫ )kpage R` ° d ONLN dÏ⁄∫Ê» )4-9 R` ° d ONLN dÔ⁄»ÊÕ ).
. ° d ONLN dÚ *
D ( *RESUL ëÄ ° d ONLN d˜ D
h )T CODES
. ° d ONLN dˇ l Ä +(The ° d ONLN d Ä » ) IpSetDisplay ° d ONLN d »" )HCharacteristics ° d ONLN d "N )Z function r R` ° d ONLN d)Nk ),eturns R` ° d ONLN d0kâ ) noErr R` ° d ONLN d5✠) upon successful . ° d ONLN dF l' † ($ l completion. ° d ONLN dR- l9 è * If an err Ö ° d ONLN d[- è9
)# or is detected, this function r ®@ ° d ONLN dz-
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä!Image Processing Module Reference
, (‡4-15 4 ^ H¿
j H r 4 j H r l H l
ˇ·ˇ‚7^
° d ONLN d \ H j „ ( f H IpInitDisplayCharacteristics ˇˇˇˇˇˇ ( f4 ,
Courier
. ° d ONLN d { ä á> ( Ñ ä OSErr FAR PASCAL IpInitDisplay ° d ONLN d < {> áò )¥Characteristics ° d ONLN d T â ï∂ ( í(unsigned char far * ipm); ° d ONLN d o ° ä ≠ ú ( ™ äipm . ° d ONLN d s ° à ≠ë )B,Pointer to the memory allocated for the IPM.
° d ONLN d † « H – Å ( Œ H DESCRIPTION
° d ONLN d ¨ ‘ ä ‡ À +BThis function r j¿ ° d ONLN d ª ‘ À ‡ )Aeplaces the curr ¢ ° d ONLN d À ‘ ‡. )Eent CR f ° d ONLN d — ‘. ‡Î ) ,T display characteristics and derived color ° d ONLN d ˝ · ä Ì ì ( Í äpr G ° d ONLN d ˇ · î Ìk )
ä8 ( ä'characteristics for subsequent image pr R` ° d ONLN d˘
8u )Æocessing. The R` ° d ONLN d
u˘ )=IpCalculateColorTables R` ° d ONLN d
˘˚ )Ñ . ° d ONLN d ä& ˆ (# äfunction is described on ’ ° d ONLN d7 ˆ&
)lpage ∞ ° d ONLN d<& )4-9 ‡ ° d ONLN d? &! ).
K HS 4K HR N äN
ˇ·ˇ‚7^
° d ONLN dB@ äK ± (H ä Table 4-2 ° d ONLN dL@ »K Ù )>
Default CR W ° d ONLN dV@ ÙK ˘ ),T ≠P ° d ONLN dW@ ˘KS ) display characteristics ° d ONLN dqX äc » (` äCharacteristic ° d ONLN dÅX ˆc )lX value ° d ONLN dâX,c2 )6Y W∞ ° d ONLN däX2cK ) value
. ° d ONLN dëf är ¿ (o ä redChroma . ° d ONLN dõf ˆr )l0.640 ° d ONLN d°f-rC )70.330 . ° d ONLN dßq ä} Ã (z ä greenChroma . ° d ONLN d≥q ˆ} )l0.300 ° d ONLN dπq-}C )70.600 . ° d ONLN dø| äà Δ (Ö ä
blueChroma . ° d ONLN d | ˆà )l0.150 ° d ONLN d–|-àC )70.060
´ H≥ 4´ H≤ Æ äÆ
ˇ·ˇ‚7^
° d ONLN d÷† ä´ ± (® ä Table 4-3 ° d ONLN d‡† »´ Ù )>
Default CR W ° d ONLN d͆ Ù´ ˘ ),T ≠P ° d ONLN dΆ ˘´o ) display gamma characteristic ° d ONLN d
∏ ä√ Δ (¿ äCharacteristic ° d ONLN d∏ ˆ√ ¸ )lV 0 ° d ONLN d∏ ¸√ )alue
. ° d ONLN d Δ ä“ ® (œ ägamma . ° d ONLN d%Δ ˆ“ )l2.3
° d ONLN d)Î HÙ b (Ú HRESUL ëÄ ° d ONLN d.Î bÙ Ü )T CODES
. ° d ONLN d6¯ ä û +(The ° d ONLN d:¯ û Ï )
IpInitDisplay ° d ONLN dG¯ ÏF )NCharacteristics ° d ONLN dV¯Fr )Z function r R` ° d ONLN da¯rè ),eturns R` ° d ONLN dh¯è≠ ) noErr R` ° d ONLN dm¯≠Û ) upon successful . ° d ONLN d~ ä æ ( ä completion. ° d ONLN dä ä# ≠ * If an err Ö ° d ONLN dì ≠#+ )# or is detected, this function r ®@ ° d ONLN d≤+#¿ )~#eturns one of the values listed her •Ä ° d ONLN d’¿#« )ïe: . ° d ONLN dÿ$ ä0 fi (- äkIpBadArgError . ° d ONLN dË$P0fl )Δ Parameter is or contains an addr ‰ ° d ONLN d$fl0 )è
ess of an ° d ONLN d/P;ù (8Pinvalid data item. . ° d ONLN d%: äF (C äkIpNoContextExistsError ° d ONLN d>:PFd )ΔThe ° d ONLN dB:dFv )ipm ° d ONLN dE:vF )# parameter does not point to valid . ° d ONLN dhEPQe (NPdata.
° d ONLN dnj Hs o (q HSEE ALSO
. ° d ONLN dww äÉ ‰ +BCharacteristics ° d ONLN dÜw ‰É
)Z data str l ° d ONLN dèw
É )&uctur >` ° d ONLN dîw É3 )e on >` ° d ONLN dôw3ÉK )page >` ° d ONLN dûwKÉY )4-6 >` ° d ONLN d°wYÉ^ ), >` ° d ONLN d£w^É‚ )IpCalculateColorTables >` ° d ONLN dπw‚É )Ñ on ° d ONLN dΩÑ äê ¢ (ç äpage ° d ONLN d¬Ñ ¢ê ∞ )4-9 ° d ONLN d≈Ñ ∞ê µ ), ° d ONLN d«Ñ µêW )IpGetDisplayCharacteristics ° d ONLN d‚ÑWêe )¢ on ° d ONLN dÊÑeê} )page ° d ONLN dÎÑ}êê )4-13 ° d ONLN dÔÑêêï ), ° d ONLN dÒë äù, (ö äIpSetDisplayCharacteristics ° d ONLN d ë,ù: )¢ on ° d ONLN dë:ùR )page ° d ONLN dëRùe )4-14 ˇ, @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-16
)B!Image Processing Module Reference 4 ^ *¿¯
j * r¯ 4 j * r¯ l * l˛
ˇ·ˇ‚7^
° d ONLN d \ * j ∑ ( f *IpGetCameraColorMatrix ˇˇˇˇˇˇ ( fÚ4 ,
Courier
. ° d ONLN d { l áÏ ( Ñ l@OSErr FAR PASCAL IpGetCameraColorMatrix(unsigned char far * ipm, ° d ONLN d c â ï¬ +¥double far * cameraMatrix); ° d ONLN d ° l ≠ ~ ( ™ lipm . ° d ONLN d É ° Æ ≠v )B-Pointer to the memory allocated for the IPM. . ° d ONLN d ± ± l Ω ¥ ( ∫ l cameraMatrix . ° d ONLN d æ Ω Æ … ≈ +B Addr C¿ ° d ONLN d ¬ Ω Δ …! )ess at which the curr (Ä ° d ONLN d ◊ Ω! …ô )[ ent camera color matrix is r ¡ ° d ONLN d Û Ωô …æ )xeturned.
° d ONLN d ¸ „ * Ï c ( Í * DESCRIPTION
. ° d ONLN d l ¸ Ä +BThe ° d ONLN d Ä ¸ )IpGetCameraColorMatrix ° d ONLN d" ¸0 )Ñ function r R` ° d ONLN d- 0 ¸p ),eturns the curr $¿ ° d ONLN d< p ¸Á )@ent camera color matrix in . ° d ONLN dW ˝ l è ( lthe user ∞ ° d ONLN d_ ˝ è Æ )#-specifi r ° d ONLN dg ˝ Ø Y ) &ed location. The memory allocated to r ó ° d ONLN dç ˝Y Ê )™ eceive this information must be . ° d ONLN d≠
l z ( llar R` ° d ONLN d∞
zX )3ge enough to contain a 3-by-4 color matrix of type R` ° d ONLN d„
X| )fidouble R` ° d ONLN dÈ
|Å )$.
% *3¯ 4% *2¯
. ° d ONLN dÏ% l- ã (+ lIMPORT Ä ° d ONLN dÚ% ã- õ ) ANT
ˇ·ˇ‚7^
° d ONLN dˆ0 l< (9 l&Since the color matrix and image compr d ° d ONLN d 0 <ü )∞ ession schemes in the camera ° d ONLN d9< lH ’ (E lmay change in the futur OÄ ° d ONLN dP< ÷Hù )j/e, it is always important to check the version ° d ONLN dH lT Á (Q l number of the color matrix. 9¿ ° d ONLN dõH ËT Ó )|Y ˙@ ° d ONLN dúH ÌTß )'ou must make adjustments in your image ° d ONLN d√T l` u (] lpr G ° d ONLN d≈T v`≠ )
Gocessing setup, based on the version number of the color matrix in the ° d ONLN d ` ll ø (i lcamera as follows: ° d ONLN d!x lÑØ *MIf the color matrix in the camera is version 1, use the default color matrix ° d ONLN dnÑ lê ë * in the W äÄ ° d ONLN dvÑ ëêõ )%:indows IPM and pass that matrix back to the IPM for image ° d ONLN d∞ê lú u (ô lpr G ° d ONLN d≤ê vú\ )
9ocessing. If it is not version 1, pass the color matrix r † ° d ONLN dÎê]ú† )Áeturned by the ° d ONLN d˙ú l®+ (• l)camera to the IPM for subsequent image pr [` ° d ONLN d#ú+®w )øocessing. See the . ° d ONLN d5® l¥ ˆ (± lIpInitCameraColorMatrix ° d ONLN dL® ˆ¥* )ä
function on ° d ONLN dY®*¥B )4page ° d ONLN d^®B¥U )4-17 ° d ONLN db®U¥û ) for information . ° d ONLN ds¥ l¿X (Ω l8about initializing the default color matrix in the IPM.
° d ONLN d¨⁄ *„ D (· *RESUL ëÄ ° d ONLN d±⁄ D„ h )T CODES
. ° d ONLN dπÁ lÛ Ä +(The ° d ONLN dΩÁ ÄÛ )IpGetCameraColorMatrix ° d ONLN d”ÁÛ0 )Ñ function r R` ° d ONLN dfiÁ0ÛM ),eturns R` ° d ONLN dÂÁMÛk ) noErr R` ° d ONLN dÍÁkÛÊ ) upon successful completion. . ° d ONLN d˘ l è ( l If an err Ö ° d ONLN d˘ è € )#or is detected, it r † ° d ONLN d$˘ ‹q )M#eturns one of the values listed her ‡ ° d ONLN dG˘qx )ïe: . ° d ONLN dJ l ¿ ( lkIpBadArgError . ° d ONLN dZ2¡ )Δ Parameter is or contains an addr ‰ ° d ONLN dz¡È )è
ess of an ° d ONLN dÑ2 (2invalid data item. . ° d ONLN dó l( ˆ (% lkIpNoContextExistsError ° d ONLN d∞ 2(F )ΔThe ° d ONLN d¥ F(X )ipm ° d ONLN d∑ X(Û )# parameter does not point to valid . ° d ONLN d⁄'23G (02data.
° d ONLN d‡L *U Q (S *SEE ALSO
. ° d ONLN dÈY le +BIpSetCameraColorMatrix ° d ONLN dˇY e: )Ñ, described next; ° d ONLN dY:eƒ )JIpInitCameraColorMatrix ° d ONLN d(Yƒe“ )ä on . ° d ONLN d,f lr É (o lpage Z‡ ° d ONLN d1f Ñr ñ )4-17 ˇé @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä!Image Processing Module Reference
, (‡4-17 4 ^ H¿
j H r 4 j H r l H l
ˇ·ˇ‚7^
° d ONLN d \ H j “ ( f HIpSetCameraColorMatrix ˇˇˇˇˇˇ ( f4 ,
Courier
. ° d ONLN d { ä á
( Ñ ä@OSErr FAR PASCAL IpSetCameraColorMatrix(unsigned char far * ipm, ° d ONLN d b â, ïŒ +¢double far * cameraMatrix); ° d ONLN d ~ ° ä ≠ ú ( ™ äipm . ° d ONLN d Ç ° à ≠î )B-Pointer to the memory allocated for the IPM. . ° d ONLN d ∞ ± ä Ω “ ( ∫ ä cameraMatrix . ° d ONLN d Ω Ω Ã … „ +B Addr C¿ ° d ONLN d ¡ Ω ‰ …† )+ess of the new 3-by-4 camera color matrix.
° d ONLN d Ì „ H Ï Å ( Í H DESCRIPTION
. ° d ONLN d ˘ ä ¸ û +BThe ° d ONLN d ˝ û ¸" )IpSetCameraColorMatrix ° d ONLN d " ¸N )Ñ function r R` ° d ONLN d N ¸¿ ),eplaces values in the curr $¿ ° d ONLN d8 ¿ ¸ )rent camera color ˇˇê» ° d ONLN dI ˝ ä Ê ( ämatrix with the user ∏ ° d ONLN d] ˝ Á e )] -supplied color tables in the ˇ˛≤X ÿ† ° d ONLN d{ ˝e ≠ )~ cameraMatrix ˇˇê» ÿ† ° d ONLN dá ˝≠ fi )H
parameter ¨ ° d ONLN dë ˝fi )1. It is used to . ° d ONLN d°
ocessing. The R` ° d ONLN dP —\U )=IpCalculateColorTables R` ° d ONLN d1PU\¿ )Ñ function is described on R` ° d ONLN dKP¿\ÿ )kpage R` ° d ONLN dPPÿ\Ê )4-9 R` ° d ONLN dSPÊ\Î ).
. ° d ONLN dVw HÄ b (~ HRESUL ëÄ ° d ONLN d[w bÄ Ü )T CODES
. ° d ONLN dcÑ äê À +(This function r R` ° d ONLN drÑ Àê Ë )Aeturns R` ° d ONLN dyÑ Ëê ) noErr R` ° d ONLN d~ÑêÅ ) upon successful completion. ˇˇÀh ° d ONLN dõñ ä¢ ≠ (ü ä If an err È0 ° d ONLN d§ñ ≠¢ Ì )#or is detected, ˇˇb8 Kh ° d ONLN d¥ñ Ó¢r )AIpSetCameraColorMatrix ˇˇÀh Kh ° d ONLN d ñr¢w )Ñ r È0 ° d ONLN dÃñw¢
)#eturns one of the values listed her ° d ONLN dÔñ¢ )óe: ° d ONLN dÚ£ äØ fi (¨ äkIpBadArgError . ° d ONLN d£PØfl )Δ Parameter is or contains an addr ‰ ° d ONLN d"£flØ )è
ess of an ° d ONLN d,ÆP∫ù (∑Pinvalid data item. . ° d ONLN d?π ä≈ (¬ äkIpNoContextExistsError ° d ONLN dXπP≈d )ΔThe ° d ONLN d\πd≈v )ipm ° d ONLN d_πv≈ )# parameter does not point to valid . ° d ONLN dǃP–e (ÕPdata.
° d ONLN dàÈ HÚ o ( HSEE ALSO
. ° d ONLN dëˆ ä +BIpCalculateColorTables ° d ONLN d߈ )Ñ on ° d ONLN d´ˆ 4 )page ° d ONLN d∞ˆ4B )4-9 ° d ONLN d≥ˆBG ), ° d ONLN dµˆGÀ )IpGetCameraColorMatrix ° d ONLN dÀˆÀŸ )Ñ on ° d ONLN dœˆŸÒ )page ° d ONLN d‘ˆÒ )4-16 ° d ONLN dÿˆ ), ° d ONLN d⁄ ä ( äIpInitCameraColorMatrix ° d ONLN dÒY )ä, described next
. ° d ONLN dR ä^ ([ äBOSErr FAR PASCAL IpInitCameraColorMatrix(unsigned char far * ipm); ° d ONLN d^j äv ú *ipm . ° d ONLN dbj Ãvî )B-Pointer to the memory allocated for the IPM.
ocessing. The R` ° d ONLN d ™ v ≥ Ç7 )=IpCalculateColorTables R` ° d ONLN d ¿ v7 Ç¢ )Ñ function is described on R` ° d ONLN d ⁄ v¢ Ç∫ )kpage R` ° d ONLN d fl v∫ Ç» )4-9 R` ° d ONLN d ‚ v» ÇÕ ).
. ° d ONLN d  ú * • D ( £ *RESUL ëÄ ° d ONLN d Í ú D • h )T CODES
. ° d ONLN d Ú ™ l ∂ Ä +(The ° d ONLN d ˆ ™ Ä ∂
)IpInitCameraColorMatrix ° d ONLN d
™
∂6 )ä function r R` ° d ONLN d ™6 ∂S ),eturns R` ° d ONLN d ™S ∂q ) noErr R` ° d ONLN d$ ™q ∂Î ) upon successful completion . ° d ONLN d@ ∑ l √ É ( ¿ land r ≤ ° d ONLN dE ∑ É √ ò )estor 5† ° d ONLN dJ ∑ ô √1 )#es the default camera color matrix. ° d ONLN dn … l ’ è ( “ l If an err Ö ° d ONLN dw … è ’ € )#or is detected, it r † ° d ONLN dã … ‹ ’q )M#eturns one of the values listed her ‡ ° d ONLN dÆ …q ’x )ïe: . ° d ONLN d± ÷ l ‚ ¿ ( fl lkIpBadArgError . ° d ONLN d¡ ÷2 ‚¡ )Δ Parameter is or contains an addr ‰ ° d ONLN d· ÷¡ ‚È )è
ess of an ° d ONLN dÎ ·2 Ì ( Í2invalid data item. . ° d ONLN d˛ Ï l ¯ ˆ ( ı lkIpNoContextExistsError ° d ONLN d Ï2 ¯F )ΔThe ° d ONLN d ÏF ¯X )ipm ° d ONLN d ÏX ¯Û )# parameter does not point to valid . ° d ONLN dA ˜2G ( 2data.
° d ONLN dG *$ Q (" *SEE ALSO
. ° d ONLN dP) l5 +BIpCalculateColorTables ° d ONLN df) 5 ˛ )Ñ on ° d ONLN dj) ˛5 )page ° d ONLN do)5$ )4-9 ° d ONLN dr)$5) ), ° d ONLN dt))5≠ )IpGetCameraColorMatrix ° d ONLN dä)≠5ª )Ñ on ° d ONLN dé)ª5” )page ° d ONLN dì)”5Ê )4-16 ° d ONLN dó)Ê5Î ), ° d ONLN dô6 lB (? lIpSetCameraColorMatrix ° d ONLN dØ6 B ˛ )Ñ on ° d ONLN d≥6 ˛B )page ° d ONLN d∏6B) )4-17
r *{¯ 4s *z¯ t *t˛
ˇ·ˇ‚7^
. ° d ONLN dΩe *s ö (o *IpGetCompressionT Õ@ ° d ONLN dŒe ôs ∞ )oable ˇˇˇˇˇˇ (oÚ4
. ° d ONLN d‘Ñ lêÊ (ç l?OSErr FAR PASCAL IpGetCompressionTable(unsigned char far * ipm, ° d ONLN d í û⁄ +¥ unsigned char far * compTable); ° d ONLN d>™ l∂ ~ (≥ lipm . ° d ONLN dB™ Æ∂s )B,Pointer to the memory allocated for the IPM. . ° d ONLN do∫ lΔ ¢ (√ l compTable . ° d ONLN dy∫ ÆΔ ≈ )BAddr C¿ ° d ONLN d}∫ ΔΔ )ess in which to stor @ ° d ONLN dë∫ΔE )U
. ° d ONLN døÌ l˘ Ä +BThe ° d ONLN d√Ì Ä˘ ˛ )IpGetCompressionTable ° d ONLN dÿÌ ˛˘* )~ function r R` ° d ONLN d„Ì*˘t ),eturns the compr $¿ ° d ONLN dÛÌt˘º )Jession table curr ˜ ° d ONLN d̪˘ )G
ently in use ° d ONLN d˙ l ( l!by the IPM at the location specifi ° d ONLN d3˙; )ó ed with the ° d ONLN d?˙;q )8 compTable ° d ONLN dH˙q£ )6
parameter ¬† ° d ONLN dR˙¢ª )1. The ¬† ° d ONLN dX˙ªÒ ) compTable ¬† ° d ONLN da˙ÒÛ )6 . ° d ONLN db l ú ( l memory ar -‡ ° d ONLN dk ù ⁄ )1ea must be lar –† ° d ONLN dy ⁄^ )= ge enough to contain the entir Ù¿ ° d ONLN dó^Å )Ñe compr ø@ ° d ONLN dûÇ· )$ession table, which is . ° d ONLN dµ l ä ( lspecifi ° d ONLN dº ä ) ed by the value of the constant ° d ONLN d‹ Ç )åkIpDecompTableSize ° d ONLN dÓÇ µ )l
(98 bytes). . ° d ONLN d¸& l2< (/ l.This function is useful when you want to ensur ≤ ° d ONLN d*&<2Ñ )–e that the compr ∞ ° d ONLN d:&Ñ2È )Hession table you specifi ò‡ ° d ONLN dR&Í2˜ )fed . ° d ONLN dU3 l? Ñ (< lin an ° d ONLN d[3 Ñ? )IpSetCompressionTable ° d ONLN dp3?q )~ function call has been pr R` ° d ONLN dä3q?Á )ooperly passed to the IPM.
. ° d ONLN d•Z *c D (a *RESUL ëÄ ° d ONLN d™Z Dc h )T CODES
. ° d ONLN d≤g ls Ä +(The ° d ONLN d∂g Äs ˛ )IpGetCompressionTable ° d ONLN dÀg ˛s* )~ function r R` ° d ONLN d÷g*sG ),eturns R` ° d ONLN d›gGse ) noErr R` ° d ONLN d‚ges‡ ) upon successful completion. ° d ONLN dˇy lÖ ê (Ç l If an err R` ° d ONLN dy êÖ — )$or is detected, R` ° d ONLN dy —ÖO )AIpGetCompressionTable R` ° d ONLN d-yOÖU )~ r $¿ ° d ONLN d/yUÖÌ )#eturns one of the values listed her ˜ ° d ONLN dRyÏÖÙ )óe: ° d ONLN dUÜ lí ¿ (è lkIpBadArgError . ° d ONLN deÜ2í¡ )Δ Parameter is or contains an addr ‰ ° d ONLN dÖÜ¡íÈ )è
ess of an ° d ONLN dèë2ù (ö2invalid data item. . ° d ONLN d¢ú l® ˆ (• lkIpNoContextExistsError ° d ONLN dªú2®F )ΔThe ° d ONLN døúF®X )ipm ° d ONLN d¬úX®Û )# parameter does not point to valid . ° d ONLN dÂß2≥G (∞2data. ˇ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä!Image Processing Module Reference
, (‡4-19 4 ^ H¿
° d ONLN d \ H e o ( c HSEE ALSO ,
Courier
. ° d ONLN d j ä v +BIpSetCompressionTable ° d ONLN d j vR )~, described next; ° d ONLN d 0 jR v÷ )JIpInitCompressionTable ° d ONLN d F j÷ v‰ )Ñ on ° d ONLN d J j‰ v¸ )page ° d ONLN d O j¸ v
)4-9
¶ H Ø 4 ß H Æ ® H ®
ˇ·ˇ‚7^
. ° d ONLN d S ô H ß µ ( £ HIpSetCompressionT #Ä ° d ONLN d d ô µ ß Ã )mable ˇˇˇˇˇˇ ( £4
. ° d ONLN d j ∏ ä ƒ ( ¡ ä?OSErr FAR PASCAL IpSetCompressionTable(unsigned char far * ipm, ° d ONLN d ¥ Δ> “¯ +¥ unsigned char far * compTable); ° d ONLN d ‘ fi ä Í ú ( Á äipm . ° d ONLN d ÿ fi à Íë )B,Pointer to the memory allocated for the IPM. . ° d ONLN d Ó ä ˙ ¿ ( ˜ ä compTable . ° d ONLN d Ó Ã ˙ „ )BAddr C¿ ° d ONLN d Ó ‰ ˙A )ess of the new compr ° ° d ONLN d' ÓA ˙y )]ession table.
° d ONLN d6 H Å ( H DESCRIPTION
. ° d ONLN dB! ä- û +BThe ° d ONLN dF! û- )IpSetCompressionTable ° d ONLN d[! -H )~ function r R` ° d ONLN df!H-è ),eplaces the curr $¿ ° d ONLN dv!è-∫ )G ent compr ˜ ° d ONLN d!π- )*ession table with ° d ONLN dë. ä: ‘ (7 äthe table specifi ° d ONLN d¢. ‘: )J
ed by the ° d ONLN d¨. :6 ), compTable ° d ONLN dµ.6:h )6
parameter ¬† ° d ONLN dø.g:õ )1 . The compr ï ° d ONLN d .õ:‡ )4ession table is r g` ° d ONLN d€.‡: )E etrieved ° d ONLN d‰; äG í (D äfr R` ° d ONLN dÊ; íG )om the camera with the R` ° d ONLN d˝;Ga )oCmGetDecompTable R` ° d ONLN d
;aG )`( camera driver function, and it must be . ° d ONLN d5H äT ˚ (Q äpassed to the IPM unalter Ê ° d ONLN dNH ˚TÇ )q ed to maintain image decompr àÄ ° d ONLN djHÉT )à ession compatibility with the ° d ONLN dàU äa fi (^ äassociated images. ° d ONLN dúg äsf *0Any time you start a new session with the QuickT É ° d ONLN dÃgfsÊ )‹ ake 100 camera, you should r <@ ° d ONLN dËgÁs )Åetrieve ° d ONLN dt äÄ ∑ (} ä the compr ^@ ° d ONLN d˘t ∑Ķ )-8ession table and set it so that the IPM can use the appr g` ° d ONLN d1t¶Ä‰ )Ô
opriate compr Δ‡ ° d ONLN d>t‰Ä )>ession ° d ONLN dEÅ äç « (ä ä
° d ONLN d]‘ H› b (€ HRESUL ëÄ ° d ONLN db‘ b› Ü )T CODES
. ° d ONLN dj· äÌ û +(The ° d ONLN dn· ûÌ )IpSetCompressionTable ° d ONLN dÉ· ÌH )~ function r R` ° d ONLN dé·HÌe ),eturns R` ° d ONLN dï·eÌÉ ) noErr R` ° d ONLN dö·ÉÌ˛ ) upon successful completion. ° d ONLN d∑Û äˇ Æ (¸ ä If an err R` ° d ONLN d¿Û Æˇ Ô )$or is detected, R` ° d ONLN d–Û Ôˇm )AIpSetCompressionTable R` ° d ONLN dÂÛmˇs )~ r $¿ ° d ONLN dÁÛsˇ )#eturns one of the values listed her ˜ ° d ONLN d
Û
ˇ )óe: ° d ONLN d
ä fi ( äkIpBadArgError . ° d ONLN d P fl )Δ Parameter is or contains an addr ‰ ° d ONLN d= fl )è
ess of an ° d ONLN dG Pù (Pinvalid data item. . ° d ONLN dZ ä" ( äkIpNoContextExistsError ° d ONLN dsP"d )ΔThe ° d ONLN dwd"v )ipm ° d ONLN dzv" )# parameter does not point to valid . ° d ONLN dù!P-e (*Pdata.
° d ONLN d£F HO o (M HSEE ALSO
. ° d ONLN d¨S ä_ Í +BCmGetDecompTable ° d ONLN dºS Í_ ¯ )` on ° d ONLN d¿S ¯_ )page ° d ONLN d≈S_# )2-45 ° d ONLN d…S#_( ), ° d ONLN dÀS(_¶ )IpGetCompressionTable ° d ONLN d‡S¶_¥ )~ on ° d ONLN d‰S¥_Ã )page ° d ONLN dÈSÃ_fl )4-18 ° d ONLN dÌSfl_‰ ), ° d ONLN dÔ` äl (i äIpInitCompressionTable ° d ONLN d`lS )Ñ, described next
ù H• 4ù H• ü Hü
ˇ·ˇ‚7^
. ° d ONLN dè Hù ∏ (ô HIpInitCompressionT ÃÄ ° d ONLN d(è ∑ù Œ )oable ˇˇˇˇˇˇ (ô4
. ° d ONLN d.Ø äª (∏ äAOSErr FAR PASCAL IpInitCompressionTable(unsigned char far * ipm); ˇ8 @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-20
)B!Image Processing Module Reference 4 ^ *¿˜ ,
Courier
. ° d ONLN d \ l h ~ ( e lipm . ° d ONLN d \ Æ hv )B-Pointer to the memory allocated for the IPM.
eturned by a $¿ ° d ONLN d ‚h Ó» )9CmGetDecompTable $¿ ° d ONLN d% ‚» ÓÛ )` function.
. ° d ONLN d1 * D ( *RESUL ëÄ ° d ONLN d6 D h )T CODES
. ° d ONLN d> l" ≠ +(This function r R` ° d ONLN dM ≠" )Aeturns R` ° d ONLN dT " Ë ) noErr R` ° d ONLN dY Ë"e ) upon successful completion. ˇˇ∂ ° d ONLN dw( l4 è (1 l If an err æÑ ° d ONLN dÄ( è4 œ )#or is detected, ˇˇ"6 ‡∫ ° d ONLN dê( œ4S )@IpInitCompressionTable ˇˇ∂ ‡∫ ° d ONLN d¶(S4X )Ñ r i, ° d ONLN d®(Y4Ô )#eturns one of the values listed her ¯ ° d ONLN dÀ(Ô4˜ )ñe: ° d ONLN dŒ5 lA ¿ (> lkIpBadArgError . ° d ONLN dfi52A¡ )Δ Parameter is or contains an addr ‰ ° d ONLN d˛5¡AÈ )è
ess of an ° d ONLN d@2L (I2invalid data item. . ° d ONLN dK lW ˆ (T lkIpNoContextExistsError ° d ONLN d4K2WF )ΔThe ° d ONLN d8KFWX )ipm ° d ONLN d;KXWÛ )# parameter does not point to valid . ° d ONLN d^V2bG (_2data.
° d ONLN ddz *É Q (Å *SEE ALSO
. ° d ONLN dmà lî à +BCmGetDecompTable ° d ONLN d}à Ãî ⁄ )` on ° d ONLN dÅà ⁄î Ú )page ° d ONLN dÜà Úî )2-45 ° d ONLN däàî
), ° d ONLN dåà
îà )IpGetCompressionTable ° d ONLN d°ààîñ )~ on ° d ONLN d•àñîÆ )page ° d ONLN d™àÆî¡ )4-18 ° d ONLN dÆà¡îΔ ), ° d ONLN d∞ï l° Í (û lIpSetCompressionTable ° d ONLN d≈ï Í° ¯ )~ on ° d ONLN d…ï ¯° )page ° d ONLN dŒï°# )4-19 ° d ONLN d“ï#°% ) ˇ
§ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä1C-Language Summary of the Image Processing Module
° d ONLN d 3 ß H ≤ y ( Ø H Constants ˇˇˇˇˇˇ a‡ ( Ø4 ,
Courier
. ° d ONLN d > ¬ H Œ à ( À HkIPMContextSize (4096) ° d ONLN d U € H Á Δ *kIpDecompTableSize 98 ° d ONLN d k Ù H ® *IpProgressInit 0 ° d ONLN d | H ¥ *IpProgressUpdate 1 ° d ONLN d è H ¢ *IpProgressEnd 2 ° d ONLN d ü) H5 Ñ *
kGray8 = 0 ° d ONLN d ¨) Ñ5 )< /* 8-bit grayscale */ ° d ONLN d √7 HC l (@ HkDIB24 ° d ONLN d Ã7 ~C ¸ )6 /* 24-bit DIB BMP */ ° d ONLN d ‚P H\ ¢ (Y HkImgRot0 = 0, ° d ONLN d ˜P ¥\J )l/* 0-degree rotation */ ° d ONLN d^ Hj ¢ (g HkImgRot90 = 1, ° d ONLN d&^ ¥jJ )l/* 90-degree rotation */ ° d ONLN d@l Hx ¢ (u HkImgRot180 = 2, ° d ONLN dUl ¥xJ )l/* 180-degree rotation */ ° d ONLN doz HÜ ú (É HkImgRot270 = 3 ° d ONLN dÉz ¥ÜJ )l/* 270-degree rotation */
∏ HΩ 4∏ HΩ π Hπ
ˇ·ˇ‚7^
. ° d ONLN dû≠ H∏ b (µ HData òp ° d ONLN d£≠ b∏ h )T µ‡ ° d ONLN d§≠ h∏ )ypes ˇˇˇˇˇˇ a‡ (µ4 ° d ONLN d™Œ H⁄ ï (◊ HImageAttribute
. ° d ONLN dπ HÒ * typedef struct imageAttribute { ° d ONLN d‡Û Δˇ& +~/* image size */ ° d ONLN dÚ Z
Æ (
Zunsigned short ° d ONLN d Δ
)l
aImgWidth; ° d ONLN d Z Æ ( Zunsigned short ° d ONLN d& Δ )l aImgLength; ° d ONLN d9 Δ)z * /* output image attributes: */ ° d ONLN dY+ Z7 ú (4 Z IpPixelType ° d ONLN dj+ Δ7 )l aPixelType; ° d ONLN dw9 ZE ú (B Z RotateAngle ° d ONLN dà9 ΔE )laAngle; ° d ONLN dóG ΔSz * /* image banding parameters */ ° d ONLN d∑U Za Æ (^ Zunsigned short ° d ONLN dÀU Δa )laStartingLine; ° d ONLN d€c Zo Æ (l Zunsigned short ° d ONLN dÔc Δo )laLinesPerBand; ° d ONLN dˇq Z} ä (z ZBoolean ° d ONLN d
q Δ} )l
firstBand; ° d ONLN d Zã ä (à ZBoolean ° d ONLN d' Δã ¸ )l lastBand; ° d ONLN d1ç Hô N (ñ H} ° d ONLN d3ç Zô ¥ )ImageAttribute; ˇ
t @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-22
)B1C-Language Summary of the Image Processing Module 4 ^ *¿¯
° d ONLN d \ * h s ( e *Characteristics ,
Courier
. ° d ONLN d t * Ä Í * typedef struct characteristics { ° d ONLN d 2 Ç < é l +XYChroma ° d ONLN d ? Ç ñ é “ )Z
redChroma; ° d ONLN d K ê < ú l ( ô <XYChroma ° d ONLN d X ê ñ ú fi )Z greenChroma; ° d ONLN d f û < ™ l ( ß <XYChroma ° d ONLN d s û ñ ™ ÿ )Z blueChroma; ° d ONLN d Ä ¨ < ∏ ` ( µ <double ° d ONLN d ã ¨ ñ ∏ ∫ )Zgamma; ° d ONLN d í ∫ * Δ ú ( √ *} Characteristics;
. ° d ONLN d ¶ Ÿ * Â a * XYChroma
. ° d ONLN d Ø * ¸ Δ *typedef struct xyChroma { ° d ONLN d À ˛ <
f +double ° d ONLN d ’ ˛ r
® )6 xChroma; ° d ONLN d ‡ < f ( <double ° d ONLN d Í r ® )6 yChroma; ° d ONLN d Ù *& r (# * } XYChroma;
. ° d ONLN d9 *E h * RotateAngle
. ° d ONLN d
Q *] Δ *typedef enum rotateAngle { ° d ONLN d1Q fi]§ )¥!/* (counterclockwise rotation) */ ° d ONLN dT_ <k ñ (h <kImgRot0 = 0, ° d ONLN dl_ fikh )¢/* 0-degree rotation */ ° d ONLN dÖm <y ñ (v <kImgRot90 = 1, ° d ONLN dùm fiyn )¢/* 90-degree rotation */ ° d ONLN d∑{ <á ñ (Ñ <kImgRot180 = 2, ° d ONLN dœ{ fiát )¢/* 180-degree rotation */ ° d ONLN dÍâ <ï ê (í <kImgRot270 = 3 ° d ONLN dâ fiït )¢/* 270-degree rotation */ ° d ONLN dó *£ Ñ († *} RotateAngle;
Δ *ï 4« *À¯ » *»¯
ˇ·ˇ‚7^
. ° d ONLN d+ª *Δ Y *# Functions ˇˇˇˇˇˇ a‡ (√Ú4
. ° d ONLN d6÷ *‚ à (fl *OSErr FAR PASCAL IpInitIPM ° d ONLN dY‰ ®D +~(unsigned char far * ipm); ° d ONLN dt˝ * Δ ( *OSErr FAR PASCAL IpEndIPM ° d ONLN dñ ®D +~(unsigned char far * ipm); ° d ONLN d±$ *0 (- *(OSErr FAR PASCAL IpConvertThumbnailToRGB ° d ONLN d·2 ®>> +~(unsigned char far * ipm, ° d ONLN d@ ®LÄ *$ unsigned char huge * pCompedTNail, ° d ONLN d.N ®Zh * unsigned char huge * pTNailRGB, ° d ONLN dV\ ®hb * ImageAttribute far * imgAttr); ° d ONLN dvu *Å (~ *!typedef struct progressCallBack { ° d ONLN dôÉ <è ¸ + IpProgressProcPtr callBackProc; ° d ONLN dªë <ù Ñ * long refcon; ° d ONLN d»ü *´ ¢ (® *} ProgressCallBack; ˇæ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 H \ , Palatino
&e . 3 +ä"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ äDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ ä˙ (‡ ä1C-Language Summary of the Image Processing Module
, (‡4-23 4 ^ H¿ ,
Courier . ° d ONLN d \ H h ( e H$OSErr FAR PASCAL IpConvertADPCMtoRGB ° d ONLN d , j Δ v\ +~(unsigned char far * ipm, ° d ONLN d M x Δ Ñå *! unsigned char huge * pCompedCDI, ° d ONLN d v Ü Δ ín * unsigned char huge * pRGB, ° d ONLN d ö î Δ †z * ImageAttribute far * imgAttr, ° d ONLN d ¿ ¢ Δ Æ™ *& ProgressCallBack far * CallBackProc); ° d ONLN d Á ª H «P ( ƒ H,OSErr FAR PASCAL IpGetDisplayCharacteristics ° d ONLN d … Δ ’b +~(unsigned char far * ipm, ° d ONLN d= ◊ Δ „∞ *'Characteristics far * characteristics); ° d ONLN de H ¸P ( ˘ H,OSErr FAR PASCAL IpSetDisplayCharacteristics ° d ONLN dô ˛ Δ
∂ H¬8 (ø H(OSErr FAR PASCAL IpInitCameraColorMatrix ° d ONLN d=ƒ Δ–b +~(unsigned char far * ipm); ° d ONLN dX› HÈ, (Ê H&OSErr FAR PASCAL IpGetCompressionTable ° d ONLN dÜÎ Δ˜\ +~(unsigned char far * ipm, ° d ONLN dߢ ΔÜ * unsigned char far * compTable); ° d ONLN d» H , ( H&OSErr FAR PASCAL IpSetCompressionTable ° d ONLN dˆ Δ,\ +~(unsigned char far * ipm, ° d ONLN d. Δ:å *! unsigned char far * compTable); ° d ONLN d9G HS2 (P H'OSErr FAR PASCAL IpInitCompressionTable ° d ONLN dhU Δah +~(unsigned char far * ipm); ˇ
@ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>4 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )Dake 100 Images in a W 0L )Yindows ä ) Application 4⁄ *˙¯
(‡ *4-24
)B1C-Language Summary of the Image Processing Module 4 ^ *¿¯
h * n¯ 4 i * m¯ j * j¯
ˇ·ˇ‚7^
° d ONLN d ] * h l ( e * Result Codes ˇˇˇˇˇˇ a‡ ( eÚ4 ,
Courier
. ° d ONLN d q * } H ( z *noErr . ° d ONLN d q ˆ }k )ÃOperation was successful. . ° d ONLN d 0 } * â r ( Ü * kIpAppCancel . ° d ONLN d > } ˆ ⣠)Ã'Operation canceled by the application. . ° d ONLN d f â * ï ~ ( í *kIpBadArgError . ° d ONLN d v â ˆ ïÖ )à Parameter is or contains an addr ‰ ° d ONLN d ñ âÖ ï )èess of an invalid data ° d ONLN d ≠ ï ˆ ° ( û ˆitem. . ° d ONLN d ¥ ° * ≠ ` ( ™ * kIpCancel . ° d ONLN d ø ° ˆ ≠û )Ã&The application wants to cancel the pr Z† ° d ONLN d  °û ≠ˆ )®ocess. The IPM will ° d ONLN d ˘ ≠ ˆ πC ( ∂ ˆdiscontinue its pr t ° d ONLN d ≠C πt )M ocess and r OÄ ° d ONLN d ≠t ππ )1eturn the value . ° d ONLN d& π ˆ ≈> ( ¬ ˆ kIpAppCancel ° d ONLN d2 π> ≈A )H. ° d ONLN d4 ≈ * — à ( Œ *KIpColorTablesNotCalculated . ° d ONLN dQ ≈ ˆ —V )ÃColor parameters wer † ° d ONLN de ≈W —Ô )a"e changed without calculating the ° d ONLN dá — ˆ ›= ( ⁄ ˆderived color pr …` ° d ONLN dó —= ›ò )Gocessing tables. Call . ° d ONLN d≠ › ˆ Èz ( Ê ˆIpCalculateColorTables ° d ONLN d√ ›z Èì )Ñ befor R` ° d ONLN d… ›ì È⁄ )e attempting to . ° d ONLN dŸ È ˆ ı ˇ ( Ú ˆpr G ° d ONLN d€ È ı^ )
ocess another image. . ° d ONLN dÒ ı * ® ( ˛ *kIpContextExistsError . ° d ONLN d ı ˆ )ÃThe ;¿ ° d ONLN d ı ) ª¿ ° d ONLN d ı 3 )
IPM is alr k‡ ° d ONLN d ı4b )+ eady open s ° d ONLN d ıbâ ).
. This err ã¿ ° d ONLN d) ı✠)'or occurs when ˇ˛ˇ˛ . ° d ONLN d8 ˆ
, (
ˆ IpInitIPM ˇˇ™™ ° d ONLN dA,
˜ )60 is called twice without an intervening call to ° d ONLN dq
ˆ& ( ˆIpEndIPM ° d ONLN dy
&+ )0. ° d ONLN d| *% ¥ (" *kIpNoContextExistsError ° d ONLN dï ˆ%
)ÃThe ° d ONLN dô
% )ipm ° d ONLN dú %– )( parameter does not point to valid data. ° d ONLN dƒ–%“ )¥ ° d ONLN dΔ% *1 ä (. *kIpNoMemoryError . ° d ONLN dÿ% ˆ1à )à System failed to allocate memory =` ° d ONLN d¯%à1ç )í. ˇ @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4⁄ ∫˙ , Palatino
3, . Ã +∫#CHAPTER ÿ )h5
ˇˇu÷ ˇÆ ° d ONLN d Z ∫ wì ( p ∫Displaying QuickT ‰ˆ ° d ONLN d Zë wÏ )◊ake 100 ° d ONLN d z ∫ ó¡ ( ê ∫Images in a Macintosh
π HX 4 π HX R HR
ˇ·ˇ‚7^ ° d ONLN d / ö ∫ ∑A * Application ˇˇˇˇˇˇ ä* ( ∞ 5
^
Ç H 4 ` } C ˇˇˇˇˇˇ , Helvetica
( f
Figure 5-0 * Listing 5-0 * T )able 5-0 ˇ T @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^
4 * \¯ , Palatino
&e . 3 +l"CHAPTER ” )>5 , Helvetica
ˇˇ—Ú ˇÆ ( @ lDisplaying QuickT ÒÚ )D ake 100 Images in a Macintosh )z Application 4⁄ *˙¯
° d ONLN d \ l hl ( e l8This chapter describes the method used to display QuickT í` ° d ONLN d 8 \l h’ ( elake 100 images with an ° d ONLN d O i l u § ( r l
application r ïÄ ° d ONLN d \ i § ug )8*unning in the Macintosh Operating System. ° d ONLN d á { l á ¿ ( Ñ lThe information pr æ@ ° d ONLN d ô { ¿ á Ú )T esented her g† ° d ONLN d § { Û á )3 e is for pr Y¿ ° d ONLN d Ø { át )*ogrammers who alr =Ä ° d ONLN d ¿ {t áÙ )Weady understand how to use ° d ONLN d € à l î å ( ë lQuickT fi‡ ° d ONLN d · à å î ¬ ) ime, QuickT √¿ ° d ONLN d Ï à ¬ î Ù )6 ime Compr Ò` ° d ONLN d ı à Ù îê )2 essors, and QuickDraw to decompr 7 ° d ONLN d àë î◊ )ùess and display ° d ONLN d% ï l ° Ü ( û lpictur È@ ° d ONLN d+ ï Ü ° ì )e fi ?† ° d ONLN d/ ï î ° ) les on the Macintosh computer º† ° d ONLN dL ï ° )á.
° d ONLN dv ‰ l " ( Ì l(As described in Chapter 3, images captur T¿ ° d ONLN dû ‰" k )∂ed in the QuickT Q¿ ° d ONLN dÆ ‰k π )Iake 100 camera ar ° d ONLN dø ‰π — )Ne stor ÛÄ ° d ONLN d≈ ‰— È )ed in ° d ONLN dÀ Ò l ˝ à ( ˙ lcompr ‡ ° d ONLN d– Ò â ˝% ) !essed format that must be decompr ‰` ° d ONLN dÒ Ò$ ˝Æ )õ essed and converted to a pictur › ° d ONLN d ÒÆ ˝È )äe format that ° d ONLN d ˛ l
p ( l:can be displayed by the host operating system. Images stor ó¿ ° d ONLN dX ˛p
description r R` ° d ONLN dZÖ •ë ∑ )9ecor $¿ ° d ONLN d^Ö ∑ë – )d is fi $¿ ° d ONLN deÖ –ë )lled in with a fi $¿ ° d ONLN dvÖëE )H le type of ,
Courier $¿ ° d ONLN dÅÖEëi )-'qktk' $¿ ° d ONLN dáÖiëÄ )$, the $¿ ° d ONLN dçÖÄë§ )height $¿ ° d ONLN dìÖ§ëπ )$ and $¿ ° d ONLN dòÖπë◊ )width $¿ ° d ONLN dùÖ◊ë‡ ) fi $¿ ° d ONLN d†Ö‡ëı ) elds ˇˇŸ˙ ° d ONLN d•í lû v (õ lar R` ° d ONLN dßí vûä )
?e set for the height and width of the image in pixels, and the ˇˇçÓ > ° d ONLN dÊíãûª (õãdataSize ˇˇŸ˙ > ° d ONLN dÓíªû√ )0 fi ° d ONLN dÒíƒû¯ ) eld is set to . ° d ONLN dˇü l´ » (® lthe size of the compr t ° d ONLN dü »´T )\ essed data in bytes. The QuickT –‡ ° d ONLN d3üS´ù )ãake 100 decompr è‡ ° d ONLN dBüû´Õ )K essor then ° d ONLN dM¨ l∏ u (µ lpr G ° d ONLN dO¨ v∏ “ )
ocesses the data to cr ü¿ ° d ONLN de¨ “∏F )\eate a Macintosh display-r .Ä ° d ONLN d¨G∏y )u eady pictur å@ ° d ONLN dä¨y∏Ü )2e fi ‚† ° d ONLN dé¨Ü∏í )
le. ° d ONLN dìæ l r (« lT µ¿ ° d ONLN dîæ q æ )o show the pictur ÿ ° d ONLN d•æ æ 9 )Mes on the Macintosh display ¸ ° d ONLN d¿æ8 Ô )z), you will need to understand how to use ° d ONLN dÈÀ l◊ å (‘ lQuickT fi‡ ° d ONLN dÔÀ å◊ Ô ) ime, the Image Compr ı ° d ONLN dÀ Ô◊4 )cession Manager º† ° d ONLN dÀ4◊‹ )E%, and QuickDraw in your application. º¿ ° d ONLN d6À‹◊‚ )®Y }@ ° d ONLN d7À‚◊Ô )ou ˇˇÖx . ° d ONLN d:ÿ l‰ (· l!should also be familiar with the ˇ˛êh †– ° d ONLN d[ÿ ‰T )îImageAttribute ˇˇÖx †– ° d ONLN diÿT‰y )T data str ó¿ ° d ONLN drÿy‰è )%uctur j ° d ONLN dwÿè‰Õ )e described on ˙à ° d ONLN dÜÿÕ‰‰ )>page ˙à ° d ONLN dãÿÂ‰Û )4-5 ˙à ° d ONLN déÿÛ‰˜ ). . ° d ONLN dê lÒ (Ó lRefer to Chapter 3 of Ú ° d ONLN d¶Â Ò3 )^Inside Macintosh: QuickT ° d ONLN dæÂ4ÒB )jime u ° d ONLN d¡ÂBÒ’ )! for information about the Image ° d ONLN d‚Ú l˛ ã (˚ lCompr ߆ ° d ONLN dÁÚ ã˛ – ) ession Manager o ° d ONLN dıÚ –˛ ’ )E. ° d ONLN d¯ l å (
lQuickT ÄÄ ° d ONLN d˛ å ⁄ ) ake 100 images ar p` ° d ONLN d ⁄K )Ne converted into display-r @† ° d ONLN d)L£ )ready PICT format fi ¥ ° d ONLN d<£œ )W les by the ° d ONLN dG l å ( lQuickT ÄÄ ° d ONLN dM å – ) ake 100 QuickT 8 ° d ONLN d[ –
)D ime decompr §` ° d ONLN df
Ñ ):essor and the Image Compr ÕÄ ° d ONLN dÑ Ò )zession Manager without ° d ONLN dñ l*û (' lFyour application having to call any of the IPM functions described in ≤‡ ° d ONLN d‹ û*Œ ('û Chapter 4, ° d ONLN dÁ+ l7 ≈ (4 l“Displaying QuickT •† ° d ONLN d˘+ ƒ7& )Xake 100 Images in a W s¿ ° d ONLN d +&7I )bindows t` ° d ONLN d +I7Ñ )#
Application.” rÄ ° d ONLN d "+Ö7Ÿ )< Converted QuickT [ ° d ONLN d 3+Ÿ7Í )Take ° d ONLN d 78 lD ® (A l
100 images ar ó ° d ONLN d D8 ®D€ )<Ce shown on the Macintosh display using the same techniques used to ° d ONLN d áE lQ Æ (N ldisplay PICT fi Á` ° d ONLN d ñE ÆQ Ù )Bles with QuickT à` ° d ONLN d •E ÙQF )Fime or QuickDraw ] ° d ONLN d µEFQK )R. ˇ¯Ï @ ˇ ˇˇˇˇ @
ˇ·ˇ‚7^ , Palatino
3, . à +ä# APPENDIX ä¨ )sA
4⁄ ä˙ , Helvetica (‡ ä Serial Port
d‡ (‡A-1
v H £ 4 v H £ û H û
ˇ·ˇ‚7^
ˇˇ¬ò ˇ◊ ° d ONLN d \ ä u ◊ ( n äQuickT ›ê ° d ONLN d \ ’ u¬ )Kake 100 Serial Interface ˇˇˇˇˇˇ h ( nA
° d ONLN d ! £ ä Øw ( ¨ ä3This appendix contains information about the QuickT 3† ° d ONLN d T £w Ø )Ì ake 100 serial interface and ° d ONLN d q ∞ ä º µ ( π ä connector /Ä ° d ONLN d z ∞ µ ºæ )+>. The serial interface is used by host computers to both contr ≠ ° d ONLN d ∏ ∞æ º˙ ( πæ
ol the QuickT ˇ ° d ONLN d ≈ ∞˘ º
);ake ° d ONLN d … Ω ä … ’ ( Δ ä100 camera and r ≤† ° d ONLN d Ÿ Ω ’ … )Ketrieve data fr J ° d ONLN d Ë Ω …U )>
om the QuickT qÄ ° d ONLN d ı ΩT …ú )Aake 100 camera.
Figure A-1 ° d ONLN dÉ= ÃH Ë )BQuickT @ ° d ONLN dâ= ËHS ) ake 100 serial port location
° d ONLN dß“ äfi¨ (€ äBIt is an 8-pin mini-DIN socket with the physical pattern shown in •Ä ° d ONLN dÈ“¨fiƒ (€¨Figur x@ ° d ONLN dÓ“ƒfiÀ )e cÄ ° d ONLN d“Àfi€ )A-2 ~† ° d ONLN dÛ“€fi ). This is the ° d ONLN dfl äÎ≠ (Ë ä?same type of serial connector used on most Macintosh computers.
H 4 H " H]
ˇ·ˇ‚7^
° d ONLN dA ä ∂ *#
Figure A-2 ° d ONLN dL Ã Ë )BQuickT @ ° d ONLN dR Ës ) $ake 100 serial port physical pattern
^
Ç H 4 ` } C ˇˇˇˇˇˇ ( f Figure ` ) A-0 ( o Listing Ç¿ ) A-0 ( x T )able P )A-0
Z á∫Ï 4Y ÜZ á ò @ @¯ @¯Z áö ¡ ¡ ¡ ˚ ˇ‡ ˝ ˇ˛ ?˛À ˝ ˝ ˇ‡Õ ˝ ¸˚ ?¸Œ
˛êêê @ į_ àüÄ ' +¸ ˇ¸ ˇˇ ˛ˇ˝ ˝ˇ¯ ˛ˇ˝ ˝ˇ ˇˇ˝ ˇˇÅ Å Å fl +¸ ˇˇ¸ ˇÒ ˇˇ¯ ˇ˘ ˇˇ¯ ˇ ˇ¸ ˇÅ Å Å fi ,˚ ˇ¸ ˇÒ ˇ˜ ˇˇ˙ ˇ˜ ˇˇÚ ˇˇ˝ ˇˇÅ Å Å fi 3˚ ˇˇ˝ ˇˇÚ ˇ¸ ˇˇ˝ ˇ˙ ˇ˚ ˇ˝ ˇÚ ˇ¸ ˇÅ Å Å › @˙ ˇˇ˝ ˇ ˇˇ˜ ˇˇ˝ ˇ ˛˛ ˇ˚ ˇˇ¸ ˇˇ˝ ˇ˜ ˛ˇ ˇˇ˝ ˇˇÅ Å Å › 7˘ ˇ˝ ˙ˇ˘ ˇ˘ ˇ˛ ˇˇ¸ ˇ˙ ˇ˝ ˇˇ˙ ˛ˇ ˛ˇ˝ ˇˇÅ Å Å ‹ 5˘ ˇˇ¯ ˇˇ˙ ˇ˙ ˇ˝ ˇˇ¸ ˇ˙ ˇ˝ ˇˇ˚ ˇˇ˜ ˇÅ Å Å € 5¯ ˇˇ¯ ˇˇ˚ ˇˇ¸ ˛¸ ˇ˚ ˇˇ˚ ˇ˝ ˇ˙ ˇ˜ ˇˇÅ Å Å € 3˜ ˇ˜ ˇ˙ ˇ˝ ˇ¸ ˇˇ˙ ˇ˚ ˇ˛ ˇˇ˙ ˇ¯ ˇˇÅ Å Å ⁄ -˜ ˇˇ¯ ˇˇ˚ ˇˇ¯ ˇ˘ ˇˇ¯ ˇ˙ ˇˇ¯ ˇÅ Å Å Ÿ /ˆ ˇˇ˘ ˇ˘ ˇˇ˙ ˇˇ¯ ˇˇ˙ ˇˇ˙ ˇˇ˘ ˇˇÅ Å Å Ÿ )ı ˇ˘ ˇ¯ ˛ˇ˛ ˛ˇˆ ˛ˇ˛ ˛ˇ¯ ˇ˙ ˇˇÅ Å Å ÿ "ı ˇˇ˚ ˇˇˆ ¸ˇÚ ¸ˇˆ ˇ˙ ˇÅ Å Å ◊ Ù ˇˇ¸ ˛ˇ‘ ˇˇ˚ ˇˇÅ Å Å ◊ Û ˇ˙ ˇˇ◊ ˛ˇ˚ ˇˇÅ Å Å ÷ Û ˛ˇ˚ ˛ˇ⁄ ˇˇ˙ ˇˇÅ Å Å ’ Ò ˇˇ˙ ˛ˇfi ˛ˇ˙ ˇˇÅ Å Å ‘ ˛ˇ˙ ˇˇ· ˛ˇ˙ ˛ˇÅ Å Å ” Ó ˇˇ˙ ˛ˇ‰ ˇˇ˘ ˇˇÅ Å Å — Ì ˛ˇ˙ ˛ˇË ˛ˇ˙ ˛ˇÅ Å Å – Î ˇˇ˘ ˚ˇÛ ˙ˇ˘ ˇˇÅ Å Å Œ Í ˛ˇˆ ˙ˇ˛ ˚ˇı ˛ˇÅ Å Å Õ Ë ˇˇÒ ¸ˇÒ ˇˇÅ Å Å À Á ˛ˇ‡ ˛ˇÅ Å Å Â ˛ˇ‰ ˛ˇÅ Å Å » „ ˝ˇÍ ˝ˇÅ Å Å Δ ‡ ¸ˇÚ ¸ˇÅ Å Å √ ‹ ˇÅ Å Å ø Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů Ä ú¯ H H ¶‘x #óÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
ˇˇ˛ ˇˇ˛ˇˇ ˛˛ˇ ˛ ˇˇ˛ ˇ˛ˇ˛ ˛ˇ ˇˇ ˛˛ˇ ˇˇ ˛ˇ ˛ˇ ˇ˛ ˇ˛ ˇˇ˛ ˇ˛ˇ ˇ˚ ˇˇ˛˛ ˛˛ˇ ˛Å Å Å ˚ Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â -· ˇ˛˛ˇ˘ ˛˛ˇ ˛Ò ˇ˘ ˇ˛ ˇˇ˛ˇ¯ ˇ˛˛ˇÅ Å Å Í +‡ ˇ˛ ˇ˘ ˇ˛ ˇÈ ˇ˝ ˇ ˇ˙ ˇ˝ ˇÅ Å Å Í M‡ ˇ˛ ˇ˘ ˇ˛ ˇ ˇˇ ˇ ˇˇ ˇ ˇˇ ˇ˛ ˇˇ˛ ˇ˝ ˇ ˇ˚ ˇ˚ ˛ˇ ˇ ˇ ˛ˇ ˇÅ Å Å ˘ L· ˇ˝ ˇ˙ ˇ˝ ˇ˛ ˇ ˛ˇ ˇ ˇˇ ˇ ˇ ˇ˝ ˇ˝ ˛˛ˇ˙ ˇ¸ ˇ ˛ ˇˇ ˇ ˛ˇ ˛Å Å Å ˘ N· ˇ˝ ˇ˙ ˇ˝ ˛ˇ ˇ ˇ ˇ ˇ ˇ ˛ˇ ˇ˝ ˇ˛ ˇ˚ ˇ¸ ˇ ˇ ˇ˛ ˇˇ ˇ ˇÅ Å Å ˘ Y· ˇ˛ ˇ˛ ˇ˝ ˇ˛ ˇ ˇ˛ ˇ ˇ ˇˇ ˇ ˇ ˇ ˇ ˇ˝ ˇ˛ ˇ ˇ˛ ˇˇ˛ ˇˇ ˇˇ ˇ˛ ˇ ˇ ˇˇÅ Å Å ˘ X‚ ˇˇ˛ˇˇ˝ ˇ˛ ˇ˛˛ˇ ˇˇ˛ ˇ ˇˇ ˛ ˇ˛ˇˇ ˛ˇ ˛˝ ˛ˇ˛ˇ˛ ˇ˝
ˇˇ˛ˇ ˇ˛ ˇ ˛˛ ˛˛ˇ˛ ˇÅ Å Å ˘ ∏ ˇ‹ ˇÅ Å Å ˘ ∏ ˇ› ˇÅ Å Å ¯
ï ˇˇÅ Å Å ˜ Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů @ į H H ¶‘x #ôÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ į˚ à;Ä ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů Ä ú¯ H H ¶‘t #öÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú¯; àWÄ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â ò @ @¯ @¯W àóÄ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ @ į @ įó à◊Ä ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ Ä ú¯ Ä ú¯◊ àÛÄ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ òů @¯ H H ¶‘x #õÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @¯W àóÄ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů @ į H H ¶‘t #úÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ įó à◊Ä ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů Ä ú¯ H H ¶‘x #ùÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú¯◊ àÛÄ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â ò @ @¯ @¯Û à3Ä ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ @ į @ į3 àsÄ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ Ä ú¯ Ä ú¯s àèÄ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ òů @¯ H H ¶‘t #ûÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @¯Û à3Ä ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů @ į H H ¶‘x #üÄ ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ į3 àsÄ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů Ä ú¯ H H ¶‘t #†Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú¯s àèÄ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â ò @ @¯ @¯è àœÄ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ @ į @ įœ àÄ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ò @ Ä ú¯ Ä ú¯ à+Ä ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ ¡ òů @¯ H H ¶‘x #°Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @¯è àœÄ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů @ į H H ¶‘t #¢Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê @ įœ àÄ ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â òů Ä ú¯ H H ¶‘x #£Ä ˛ ˇˇˇˇˇˇ ˇˇˇˇÃà ˇˇˇˇôô ˇˇˇˇff ˇˇˇˇ33 ˇˇˇˇ ˇˇÃÃˇˇ ˇˇÃÃÃà ˇˇÃÃôô ˇˇÃÃff
˛êêê Ä ú¯ à+Ä ' Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â Å Å Å â ˇ∏ @ ˇ ˇˇˇˇ @
\ • k ≠ )9T fi ° d ONLN d \ ≠ kf ) ransfer Rate, and Data Format ˇˇˇˇˇˇ MR ( gÔA
° d ONLN d * r l ~ † ( { l
The QuickT º@ ° d ONLN d 4 r ü ~¡ )3Aake 100 serial port supports Macintosh GeoPort high-speed serial ° d ONLN d u l ã Ω ( à lcommunication pr ˜† ° d ONLN d Ö Ω ã¥ )Q8otocols up to 920 kilobits per second (Kbps) and standar ù ° d ONLN d Ω µ ã )¯
d RS-232C ° d ONLN d « å l ò ê ( ï l serial pr ë ° d ONLN d – å ê òI )$,otocols up to 57,600 bits per second (bps). ÄÄ ° d ONLN d ¸ åJ òL )∫ ° d ONLN d ˛ û l ™ « ( ß lThe GeoPort softwar 4‡ ° d ONLN d û » ™+ )\e built into the QuickT Ô‡ ° d ONLN d( û* ™‹ )b&ake 100 camera and the GeoPort system ° d ONLN dN ´ l ∑7 ( ¥ l,extension on the Macintosh computer take car ◊† ° d ONLN dz ´7 ∑ù )Àe of setting up the appr n¿ ° d ONLN dí ´û ∑ø )gopriate ° d ONLN dö ∏ l ƒ Ω ( ¡ lcommunication pr ˜† ° d ONLN d™ ∏ Ω ƒå )Q2otocol and transfer rate for a serial connection. ° d ONLN d‹ ∏ç ƒˆ )–At system startup time, ° d ONLN dÙ ≈ l — ≈ ( Œ lthe GeoPort softwar VÄ ° d ONLN d ≈ ≈ —Ê )Y@e performs what is called a beaconing phase. During the GeoPort ° d ONLN dG “ l fi ( € l"beaconing phase many device-specifi œ¿ ° d ONLN dj “ fi* )§c chor < ° d ONLN dp “+ fi? )es ar á¿ ° d ONLN du “? fi‹ )%e attended to; one of these includes ° d ONLN dö fl l Îœ ( Ë lRdetermining the fastest possible data transfer rate that can be supported by both ° d ONLN dÏ Ï l ¯ å *
QuickT ÄÄ ° d ONLN dÚ Ï å ¯û ) =ake 100 and the Macintosh computer to which it is connected. ° d ONLN d0 ˛ l
¸ ( l For computers that support Micr Q¿ ° d ONLN dO ˛ ˝
)ëosoft W ` ° d ONLN dV ˛
v )"indows, the QuickT @@ ° d ONLN dh ˛u
· )Vake 100 camera uses the ° d ONLN dÄ l ∏ ( lRS-232C serial pr i¿ ° d ONLN dë ∏Ê )LGotocol with a default transfer rate of 9600 bps and a data format of 8 ° d ONLN dÿ l$ (! l+data bits, with 1 stop bit, and even parity T‡ ° d ONLN d $Y )¥ . The QuickT ë ° d ONLN dX$ú )8ake 100 softwar N† ° d ONLN d ù$Ú )Ee supports transfer ° d ONLN d2% l1V (. l7rates of 9600, 19,200, 38,400, and 57,600 bps for the W E† ° d ONLN di%V1• )Íindows platform.
V *]¯ 4W *]¯ X lX¯
ˇ·ˇ‚7^
ˇˇ‹. ˇ◊ ° d ONLN d{G lV ó (R lQuickT pî ° d ONLN dÅG ñV% )*ake 100 Serial Port Pin Xƒ ° d ONLN dôG%Vs )è Assignments ˇˇˇˇˇˇ MR ) A
° d ONLN d¶] li † (f l
The QuickT º@ ° d ONLN d∞] üiV )3*ake 100 serial port conforms to RS-422 dif ≥† ° d ONLN d⁄]Vib )∑fer ñ ° d ONLN d›]bi≤ ) ential driver and r œ† ° d ONLN d]≤i” )Peceiver ° d ONLN d¯j lv à (s lspecifi Ó ° d ONLN dˇj àva ) 1cations and has the pin assignments described in Á` ° d ONLN d0jbvh )⁄T ° d ONLN d1jhv| )able x` ° d ONLN d6j|vå )A-1 ìÄ ° d ONLN d9jåvë ).
ö *¢¯ 4õ *¢¯ û lû¯
ˇ·ˇ‚7^
° d ONLN d<ê lõ î (ò l Table A-1 ° d ONLN dFê ™õ )>Serial port pin assignments ° d ONLN dd® l≥ ù (∞ l
Pin number ° d ONLN do® Ø≥ ‰ )C Signal name ° d ONLN d{® ¸≥I )MSignal description
° d ONLN dè∂ l¬ q (ø l1 ° d ONLN dë∂ Ƭ » )BHSKo ° d ONLN dñ∂ ¸¬È )N6Handshake output. This is the clock out signal on the ° d ONLN dá ¸Õ * QuickT ÄÄ ° d ONLN d“¡ ÕÌ ) .ake 100 camera and is not used by the RS-232C ° d ONLN d à ¸ÿ (’ ¸standar ±Ä ° d ONLN dà ÿI )! d serial pr ^` ° d ONLN dÃJÿi )-otocol. ° d ONLN d fi lÍ q (Á l2 ° d ONLN d fi ÆÍ ≈ )BHSKi ° d ONLN d#fi ¸ÍÅ )N Handshake input. This is the r
@ ° d ONLN dAfiÇÍ€ )Üeset in signal on the ° d ONLN dWÈ ¸ı (Ú ¸QuickT ÄÄ ° d ONLN d]È ıa ) ake 100 camera. ° d ONLN dn˚ l q ( l3 ° d ONLN dp˚ Æ Δ )BTxD– ° d ONLN du˚ ¸ )NT ∫¿ ° d ONLN dv˚; )
ransmit data. ° d ONLN dÖ
l q ( l4 ° d ONLN dá
Æ ≈ )BGND ° d ONLN dã
¸# )N Signal gr ≈ ° d ONLN dî
#< )'ound. ° d ONLN dõ l+ q (( l5 ° d ONLN dù Æ+ Δ )BRxD– ° d ONLN d¢ ¸+6 )N
Receive data. ° d ONLN d±1 l= q (: l6 ° d ONLN d≥1 Æ= « )BTxD+ ° d ONLN d∏1 ¸= )NT ∫¿ ° d ONLN dπ1=ñ )!ransmit data (not used by standar ÁÄ ° d ONLN d⁄1ñ=¬ )ï d serial pr î` ° d ONLN dÂ1√=„ )-otocol). ° d ONLN dÔC lO q (L l7 ° d ONLN dÒC ÆO æ )BGPi ° d ONLN dıC ¸O' )N Not used. ° d ONLN d U la q (^ l8 ° d ONLN dU Æa « )BRxD+ ° d ONLN dU ¸aë )N!Receive data (not used by standar ∂¿ ° d ONLN d(UëaΩ )ï d serial pr c† ° d ONLN d3Uæafi )-otocol). ˇCj @ ˇ ˇˇˇˇ @
with a QuickT ”† ° d ONLN d Á » Û )>ake 100 camera. ° d ONLN d, ˘ ä ê ( äT µ¿ ° d ONLN d- ˘ è] ),o connect a Macintosh computer to the QuickT l‡ ° d ONLN dY ˘]ƒ )Œake 100 camera, use an F‡ ° d ONLN dp ˘ƒ¸ )g
Apple serial ° d ONLN d} ä ( äTcable, part number M0197, or a cable with the pin and signal assignment connections ° d ONLN d— ä µ *
shown in Ê ° d ONLN d⁄ µ Õ )+Figur ∏¿ ° d ONLN dfl Õ ‘ )e § ° d ONLN d· ‘ ‰ )A-4 ø ° d ONLN d‰ ‰ È ).
A HR 4B HR "B H]
ˇ·ˇ‚7^
° d ONLN dÁ7 äB ∂ (? ä
Figure A-3 ° d ONLN dÚ7 ÃB Ë )BQuickT @ ° d ONLN d¯7 ËBn ) !ake 100-to-Macintosh serial cable
À H‹ 4Ã H‹ "Ã H]
ˇ·ˇ‚7^ ° d ONLN d¡ äà ∂ (… ä
Figure A-4 ° d ONLN d&¡ ÃÃ Ë )BQuickT @ ° d ONLN d,¡ ËÃ≤ ) 1ake 100-to-Macintosh serial cable pin assignments
